@koine/react 2.0.0-beta.12 → 2.0.0-beta.120

package/Autocomplete/AutocompleteDownshift.mjs

@@ -1,157 +0,0 @@
-// TODO: remove, just use mui version...
-export const Autocomplete = null; // import {
- //   forwardRef,
- //   useCallback,
- //   useState,
- //   ForwardedRef,
- //   ReactNode,
- //   ComponentPropsWithRef,
- //   CSSProperties,
- // } from "react";
- // import { useCombobox } from "downshift";
- // import type { SetRequired } from "@koine/utils";
- // // import debounce from "lodash.debounce";
- // import {
- //   AutocompleteRoot,
- //   AutocompleteLabel,
- //   AutocompleteInputWrap,
- //   AutocompleteInput,
- //   AutocompleteInputArrow,
- //   AutocompleteMenu,
- //   AutocompleteMenuItem,
- // } from "./components";
- // import { defaultOptionsFilterFn, triggerOnChange } from "../Forms/helpers";
- // import { InputProgress } from "../Forms/styles";
- // export type AutocompleteOption = Option;
- // export type AutocompleteValue = null | AutocompleteOption;
- // export type AutocompleteProps = SetRequired<
- //   Omit<ComponentPropsWithRef<"input">, "onSelect">,
- //   "onChange" | "name"
- // > & {
- //   freeSolo?: boolean;
- //   onSelect?: (option?: AutocompleteValue) => any;
- //   options?: AutocompleteOption[];
- //   loadOptions: (query?: string) => Promise<AutocompleteOption[]>;
- //   label?: string | ReactNode;
- //   className?: string;
- //   style?: CSSProperties;
- //   $ref: ForwardedRef<HTMLInputElement>;
- // };
- // export const Autocomplete = forwardRef<HTMLInputElement, AutocompleteProps>(
- //   function Autocomplete(
- //     {
- //       freeSolo,
- //       onSelect,
- //       options = [],
- //       label,
- //       name,
- //       value,
- //       onChange,
- //       loadOptions,
- //       className,
- //       style,
- //       $ref,
- //       ...props
- //     },
- //     ref
- //   ) {
- //     const [items, setItems] = useState(options);
- //     const [loading, setLoading] = useState(false);
- //     const triggerChange = useCallback(
- //       (selectedItem?: AutocompleteValue, inputValue?: string) => {
- //         const value = freeSolo ? inputValue : selectedItem?.value;
- //         triggerOnChange(onChange, name, value || "");
- //         if (onSelect) onSelect(selectedItem);
- //       },
- //       [onChange, onSelect, name, freeSolo]
- //     );
- //     const handleInputValueChange = useCallback(
- //       async ({ inputValue }) => {
- //         if (inputValue) {
- //           if (loadOptions) {
- //             setLoading(true);
- //             try {
- //               const newOptions = await loadOptions(inputValue);
- //               setItems(newOptions);
- //             } catch (e) {}
- //             setLoading(false);
- //           } else {
- //             setItems(defaultOptionsFilterFn(options, inputValue));
- //           }
- //         } else {
- //           setItems(options);
- //           // clear like behaviour
- //           triggerChange({ value: "", label: "" });
- //         }
- //       },
- //       [loadOptions, triggerChange]
- //     );
- //     const {
- //       isOpen,
- //       // selectedItem,
- //       getToggleButtonProps,
- //       getLabelProps,
- //       getMenuProps,
- //       getInputProps,
- //       getComboboxProps,
- //       highlightedIndex,
- //       getItemProps,
- //       openMenu,
- //     } = useCombobox<null | AutocompleteOption>({
- //       id: `Autocomplete-${name}`,
- //       items,
- //       // initialInputValue: value,
- //       onSelectedItemChange: ({ selectedItem, inputValue }) => {
- //         triggerChange(selectedItem, inputValue);
- //       },
- //       // itemToString: (item) => (item ? item.label || item.value : ""),
- //       onInputValueChange: handleInputValueChange,
- //     });
- //     // const debouncedInputValueChangeHandler = useCallback(
- //     //   debounce(handleInputValueChange, 200),
- //     //   [handleInputValueChange]
- //     // );
- //     return (
- //       <AutocompleteRoot className={className} style={style}>
- //         {label && (
- //           <AutocompleteLabel {...getLabelProps()}>{label}</AutocompleteLabel>
- //         )}
- //         <AutocompleteInputWrap {...getComboboxProps()}>
- //           <AutocompleteInput
- //             {...getInputProps({
- //               onFocus: openMenu,
- //               onClick: openMenu,
- //               ref: $ref || ref,
- //               // itemRef: ref,
- //             })}
- //             {...props}
- //           />
- //           {!!items.length && (
- //             <AutocompleteInputArrow
- //               {...getToggleButtonProps()}
- //               aria-label={"toggle menu"}
- //             />
- //           )}
- //           {loading && <InputProgress />}
- //         </AutocompleteInputWrap>
- //         <AutocompleteMenu {...getMenuProps()}>
- //           {isOpen &&
- //             items
- //               // .filter(item => !inputValue || item.includes(inputValue))
- //               .map(
- //                 (item, index) =>
- //                   item && (
- //                     <AutocompleteMenuItem
- //                       $active={highlightedIndex === index}
- //                       key={`${item.value}${index}`}
- //                       {...getItemProps({ item, index })}
- //                     >
- //                       {item.label}
- //                     </AutocompleteMenuItem>
- //                   )
- //               )}
- //         </AutocompleteMenu>
- //       </AutocompleteRoot>
- //     );
- //   }
- // );

package/Autocomplete/AutocompleteDownshiftMultiselect.d.ts

@@ -1 +0,0 @@
-export declare const Autocomplete: null;

package/Autocomplete/AutocompleteDownshiftMultiselect.mjs

@@ -1,352 +0,0 @@
-// TODO: remove, just use mui version...
-export const Autocomplete = null; // import {
- //   forwardRef,
- //   useCallback,
- //   useEffect,
- //   useRef,
- //   useState,
- //   ForwardedRef,
- //   ReactNode,
- //   ComponentPropsWithRef,
- //   CSSProperties,
- // } from "react";
- // import type { SetRequired } from "@koine/utils";
- // import {
- //   useCombobox,
- //   useMultipleSelection,
- //   UseMultipleSelectionProps,
- //   UseMultipleSelectionStateChange,
- //   UseMultipleSelectionReturnValue,
- // } from "downshift";
- // import { usePopper } from "react-popper"; // imports from downshift demo
- // // import { useDeepCompareEffect } from "react-use"; // imports from downshift demo
- // import type { Option } from "../types";
- // import {
- //   normaliseOptions,
- //   defaultOptionsFilterFn,
- //   triggerOnChange,
- // } from "../Forms/helpers";
- // import {
- //   AutocompleteRoot,
- //   AutocompleteLabel,
- //   AutocompleteWrap,
- //   AutocompleteInner,
- //   AutocompleteItem,
- //   AutocompleteItemLabel,
- //   AutocompleteItemRemove,
- //   AutocompleteInputWrap,
- //   AutocompleteInput,
- //   AutocompleteInputArrow,
- //   AutocompleteMenu,
- //   AutocompleteMenuItem,
- // } from "./components";
- // const USE_POPPER = false;
- // export type AutocompleteItem = Option;
- // export type AutocompleteValue = AutocompleteItem[];
- // export type AutocompleteProps = SetRequired<
- //   Omit<ComponentPropsWithRef<"input">, "defaultValue" | "onSelect">,
- //   "onChange" | "name"
- // > & {
- //   selectedItems: UseMultipleSelectionReturnValue<AutocompleteItem>["selectedItems"];
- //   onSelectedItemsChange: UseMultipleSelectionProps<AutocompleteItem>["onSelectedItemsChange"];
- //   onCreateItem: (item?: AutocompleteItem) => any;
- //   creatable?: boolean;
- //   onSelect?: (value?: AutocompleteValue) => any;
- //   options?: AutocompleteItem[];
- //   loadOptions?: (query?: string) => Promise<AutocompleteItem[]>;
- //   label?: string | ReactNode;
- //   defaultValue?: AutocompleteValue | string[];
- //   className?: string;
- //   style?: CSSProperties;
- //   $ref?: ForwardedRef<HTMLInputElement>;
- // };
- // /**
- //  * @see https://www.downshift-js.com/use-multiple-selection
- //  * @see https://codesandbox.io/s/y34o5l3p61?file=/src/hooks/useMultipleSelection/combobox.js
- //  * @see https://codesandbox.io/s/y34o5l3p61?file=/src/downshift/ordered-examples/05-multi-create.js
- //  */
- // export const _Autocomplete = forwardRef<HTMLInputElement, AutocompleteProps>(
- //   function _Autocomplete(
- //     {
- //       selectedItems,
- //       onSelectedItemsChange,
- //       onCreateItem,
- //       creatable,
- //       onSelect,
- //       options = [],
- //       label,
- //       loadOptions,
- //       $ref,
- //       className,
- //       style,
- //       ...props
- //     },
- //     ref
- //   ) {
- //     options = normaliseOptions(options);
- //     const [isCreating, setIsCreating] = useState(false);
- //     const [filteredOptions, setFilteredOptions] = useState(options);
- //     const disclosureRef = useRef(null);
- //     const popoverRef = useRef(null);
- //     const { styles, attributes } = USE_POPPER
- //       ? usePopper(disclosureRef.current, popoverRef.current, {
- //           placement: "bottom-start",
- //         })
- //       : { styles: {}, attributes: {} };
- //     const {
- //       getSelectedItemProps,
- //       getDropdownProps,
- //       addSelectedItem,
- //       removeSelectedItem,
- //       // selectedItems,
- //       activeIndex,
- //     } = useMultipleSelection<AutocompleteItem>({
- //       selectedItems,
- //       onSelectedItemsChange,
- //       // onSelectedItemsChange: ({ selectedItems = [] }) => {
- //       //   triggerChange(selectedItems);
- //       // },
- //       // initialSelectedItems: normaliseOptions(defaultValue),
- //       stateReducer: (_, actionAndChanges) => {
- //         const { type, changes } = actionAndChanges;
- //         switch (type) {
- //           case useMultipleSelection.stateChangeTypes.FunctionRemoveSelectedItem:
- //             return {
- //               ...changes,
- //               activeIndex: undefined,
- //             };
- //           default:
- //             return changes;
- //         }
- //       },
- //     });
- //     const selectedItemsValues = selectedItems.map((item) => item.value);
- //     const {
- //       isOpen,
- //       getToggleButtonProps,
- //       getLabelProps,
- //       getMenuProps,
- //       getInputProps,
- //       getComboboxProps,
- //       highlightedIndex,
- //       getItemProps,
- //       openMenu,
- //       selectItem,
- //       setHighlightedIndex,
- //       inputValue,
- //     } = useCombobox<null | AutocompleteItem>({
- //       selectedItem: null,
- //       items: filteredOptions,
- //       onInputValueChange: ({ inputValue }) => {
- //         // perhaps allows the optionsFilterFn as prop
- //         const filteredItems = defaultOptionsFilterFn(options, inputValue);
- //         if (creatable && isCreating && filteredItems.length > 0) {
- //           setIsCreating(false);
- //         }
- //         setFilteredOptions(filteredItems);
- //       },
- //       stateReducer: (state, actionAndChanges) => {
- //         const { changes, type } = actionAndChanges;
- //         switch (type) {
- //           case useCombobox.stateChangeTypes.InputBlur:
- //             return {
- //               ...changes,
- //               highlightedIndex: state.highlightedIndex,
- //               // clear input on blur to avoid have "pending" uncompleted behaviours
- //               inputValue: "",
- //             };
- //           case useCombobox.stateChangeTypes.InputKeyDownEnter:
- //           case useCombobox.stateChangeTypes.ItemClick:
- //             return {
- //               ...changes,
- //               highlightedIndex: state.highlightedIndex,
- //               isOpen: true,
- //               inputValue: "",
- //             };
- //           default:
- //             return changes;
- //         }
- //       },
- //       onStateChange: ({ type, selectedItem }) => {
- //         switch (type) {
- //           case useCombobox.stateChangeTypes.InputKeyDownEnter:
- //           case useCombobox.stateChangeTypes.ItemClick:
- //             if (selectedItem) {
- //               if (selectedItemsValues.includes(selectedItem.value)) {
- //                 removeSelectedItem(selectedItem);
- //               } else {
- //                 if (creatable && onCreateItem) {
- //                   onCreateItem(selectedItem);
- //                 }
- //                 addSelectedItem(selectedItem);
- //                 if (isCreating) {
- //                   setIsCreating(false);
- //                   setFilteredOptions(options);
- //                 }
- //               }
- //               selectItem(null);
- //             }
- //             break;
- //           default:
- //             break;
- //         }
- //       },
- //     });
- //     useEffect(() => {
- //       if (
- //         creatable &&
- //         filteredOptions.length === 0 &&
- //         activeIndex === -1 &&
- //         inputValue.length > 0
- //       ) {
- //         setIsCreating(true);
- //         setFilteredOptions(normaliseOptions([inputValue]));
- //         setHighlightedIndex(0);
- //       }
- //     }, [
- //       creatable,
- //       filteredOptions,
- //       setIsCreating,
- //       setHighlightedIndex,
- //       inputValue,
- //       activeIndex,
- //     ]);
- //     // useEffect(() => {
- //     //   setSelectedItems(normaliseOptions(defaultValue));
- //     // }, [defaultValue]);
- //     // useDeepCompareEffect(() => {
- //     //   setFilteredOptions(options);
- //     // }, [options]);
- //     // useDeepCompareEffect(() => {
- //     //   triggerChange(values);
- //     // }, [values]);
- //     return (
- //       <AutocompleteRoot>
- //         {label && (
- //           <AutocompleteLabel {...getLabelProps()}>{label}</AutocompleteLabel>
- //         )}
- //         <AutocompleteWrap
- //           {...getComboboxProps({
- //             ref: disclosureRef,
- //           })}
- //         >
- //           <AutocompleteInner>
- //             {selectedItems.map((selectedItem, index) => (
- //               <AutocompleteItem
- //                 key={`selected-item-${index}`}
- //                 {...getSelectedItemProps({ selectedItem, index })}
- //               >
- //                 <AutocompleteItemLabel>
- //                   {selectedItem?.label || selectedItem}
- //                 </AutocompleteItemLabel>
- //                 <AutocompleteItemRemove
- //                   onClick={(e) => {
- //                     e.stopPropagation();
- //                     removeSelectedItem(selectedItem);
- //                   }}
- //                 >
- //                   &#10005;
- //                 </AutocompleteItemRemove>
- //               </AutocompleteItem>
- //             ))}
- //             <AutocompleteInputWrap>
- //               <AutocompleteInput
- //                 {...getInputProps({
- //                   ...getDropdownProps({
- //                     // this option used in the official example prevents the
- //                     // backspace key to behave correctly
- //                     // preventKeyAction: isOpen,
- //                     onClick: isOpen ? () => {} : openMenu,
- //                     onFocus: isOpen ? () => {} : openMenu,
- //                     ref: $ref || ref,
- //                     // ref: disclosureRef,
- //                   }),
- //                   // ref: $ref || ref,
- //                 })}
- //                 {...props}
- //               />
- //             </AutocompleteInputWrap>
- //           </AutocompleteInner>
- //           {!!filteredOptions.length && (
- //             <AutocompleteInputArrow
- //               {...getToggleButtonProps()}
- //               aria-label={"toggle menu"}
- //               isOpen={isOpen}
- //             />
- //           )}
- //         </AutocompleteWrap>
- //         <AutocompleteMenu
- //           style={styles.popper}
- //           {...attributes.popper}
- //           {...getMenuProps({ ref: popoverRef })}
- //         >
- //           {isOpen &&
- //             filteredOptions.map((item, index) => (
- //               <AutocompleteMenuItem
- //                 $active={highlightedIndex === index}
- //                 key={`${item.value}${index}`}
- //                 {...getItemProps({ item, index })}
- //               >
- //                 {isCreating ? (
- //                   <>
- //                     <span>+</span> <strong>{item.label}</strong>
- //                   </>
- //                 ) : (
- //                   <>
- //                     {/* {selectedItemsValues.includes(item.value) && (
- //                       <CheckboxToggle />
- //                     )} */}
- //                     {item.label}
- //                   </>
- //                 )}
- //               </AutocompleteMenuItem>
- //             ))}
- //         </AutocompleteMenu>
- //       </AutocompleteRoot>
- //     );
- //   }
- // );
- // /**
- //  * @see https://www.downshift-js.com/use-multiple-selection
- //  * @see https://codesandbox.io/s/y34o5l3p61?file=/src/hooks/useMultipleSelection/combobox.js
- //  * @see https://codesandbox.io/s/y34o5l3p61?file=/src/downshift/ordered-examples/05-multi-create.js
- //  */
- // export const Autocomplete = forwardRef<HTMLInputElement, AutocompleteProps>(
- //   function Autocomplete(
- //     { defaultValue = [], onChange, onSelect, name, ...props },
- //     ref
- //   ) {
- //     const [selectedItems, setSelectedItems] = useState(
- //       normaliseOptions(defaultValue)
- //     );
- //     const triggerChange = useCallback(
- //       (values: AutocompleteValue) => {
- //         triggerOnChange(
- //           onChange,
- //           name,
- //           values.map((item) => item.value || item)
- //         );
- //         if (onSelect) onSelect(values);
- //       },
- //       [onChange, onSelect, name]
- //     );
- //     const handleCreateItem = (item?: AutocompleteItem) => {
- //       // setSelectedItems((curr) => [...curr, item]);
- //     };
- //     const handleSelectedItemsChange = ({
- //       selectedItems = [],
- //     }: UseMultipleSelectionStateChange<AutocompleteItem>) => {
- //       setSelectedItems(selectedItems);
- //       triggerChange(selectedItems);
- //     };
- //     return (
- //       <_Autocomplete
- //         {...props}
- //         selectedItems={selectedItems}
- //         onSelectedItemsChange={handleSelectedItemsChange}
- //         onCreateItem={handleCreateItem}
- //         $ref={ref}
- //       />
- //     );
- //   }
- // );

package/Autocomplete/AutocompleteMui.d.ts

@@ -1,47 +0,0 @@
-import React from "react";
-import { FormControl } from "../Forms/helpers";
-import type { Option } from "../types";
-export type AutocompleteOption = Option | string;
-export type AutocompleteValue<TMultiple extends boolean | undefined = undefined> = TMultiple extends undefined ? null | Option[] | string[] | Option | string : TMultiple extends true ? Option[] | string[] : null | Option | string;
-export type AutocompleteConfig<TOption extends AutocompleteOption, TValue extends AutocompleteValue> = {
-    creatable?: boolean;
-    multiple?: boolean;
-    autoComplete?: boolean;
-    options?: TOption[];
-    loadOptions?: (query?: string) => Promise<TOption[]>;
-    onChange?: (value: TValue) => any;
-    defaultValue?: TValue;
-    value?: TValue;
-    defaultInputValue?: string;
-};
-export type AutocompleteProps<TOption extends AutocompleteOption, TValue extends AutocompleteValue> = Omit<FormControl, keyof AutocompleteConfig<TOption, TValue>> & AutocompleteConfig<TOption, TValue> & {
-    className?: string;
-    style?: React.CSSProperties;
-    $ref?: React.ForwardedRef<HTMLInputElement>;
-};
-/**
- * Autocomplete/autocomplete component based on [`@mui useAutocomplete hook`](https://mui.com/components/autocomplete/#useautocomplete/useAutocomplete).
- *
- * This component is design to work out of the box with [`react-hook-form`](https://react-hook-form.com/)
- * and [`yup`](https://github.com/jquense/yup) alongside our custom `Field`
- * component.
- *
- * After a lot of tests and attempts with `downshift` and `@reach` this proved
- * the best headless hook, small in size and behaving correctly in all scenarios.
- * `downshift` had in fact problems treating the initial `defaultValue` which
- * here is elegantly managed by the `isOptionEqualToValue` option passed into
- * the `useAutocomplete` hoo/useAutocompletek.
- *
- *
- * Validation with `yup` and `react-hook-form` example:
- *
- * ```ts
- * const schema = object({
- *   // the value must be an array with at least one non-empty string
- *   test1: array(string().required()).required().min(1),
- *   // the value must be an array of strings or an empty array
- *   test2: array(string().required()).required(),
- * }).required();
- * ```
- */
-export declare const Autocomplete: <TOption extends AutocompleteOption = AutocompleteOption, TValue extends string | string[] | Option | Option[] | null = string | string[] | Option | Option[] | null>({ creatable, multiple, autoComplete, loadOptions, options: defaultOptions, defaultValue, value: controlledValue, defaultInputValue, label, placeholder, register, setValue, name, onChange, $ref, children, ...props }: AutocompleteProps<TOption, TValue>) => import("react/jsx-runtime").JSX.Element;