@dktunited-techoff/techoff-suite-ui 1.8.1 → 1.8.2

package/esm/components/TsDropdowns/TsDropdown/TsDropdown.tsx

@@ -0,0 +1,165 @@
+import * as React from 'react';
+import { useEffect, useRef, useState } from 'react';
+import { TsDropdownProps } from './TsDropdown.types';
+import { TsIcon } from '../../TsIcon/TsIcon';
+import { TsInput } from '../../TsInput/TsInput/TsInput';
+import { useClickOutside } from '../../../hooks/use-click-outside';
+import { TsLoader } from '../../TsLoader/TsLoader';
+import './TsDropdown.css';
+
+export const TsDropdown = <T,>({
+  containerRef,
+  error,
+  label,
+  options,
+  placeholder,
+  reloadOptionsOn = [],
+  searchPlaceholder,
+  value,
+  disabled,
+  searchable,
+  getOptionLabel,
+  getOptionValue,
+  loadOptions,
+  onChange,
+}: TsDropdownProps<T>) => {
+  const [showDropdownMenu, setShowDropdownMenu] = useState<boolean>(false);
+  const [searchValue, setSearchValue] = useState<string>('');
+  const [items, setItems] = useState<T[]>(options ?? []);
+  const [loading, setLoading] = useState<boolean>(false);
+  const [isFetchError, setIsFetchError] = useState<boolean>(false);
+  const dropdownRef = useClickOutside(() => setShowDropdownMenu(false));
+  const dropdownMenuRef = useRef<HTMLDivElement>(null);
+
+  // ########
+  // Fetchers
+  const fetchOptions = () => {
+    if (!options && loadOptions) {
+      setLoading(true);
+      setIsFetchError(false);
+      loadOptions(searchValue)
+        .then(setItems)
+        .catch(() => setIsFetchError(true))
+        .finally(() => setLoading(false));
+    }
+  };
+
+  // ########
+  // Handlers
+  const handleSelectItem = (item: T) => {
+    setShowDropdownMenu(false);
+    onChange(item);
+  };
+  const handleShowDropdownMenu = () => !disabled && setShowDropdownMenu(true);
+
+  // ########
+  // Watchers
+  useEffect(() => {
+    if (!disabled) fetchOptions();
+  }, [...reloadOptionsOn, disabled]);
+  useEffect(() => {
+    if (searchable && options) {
+      setItems(options.filter(option => getOptionLabel(option).toLowerCase().includes(searchValue.toLowerCase())));
+    }
+
+    if (searchable && !options && loadOptions) {
+      setLoading(true);
+      setIsFetchError(false);
+      const timeOutId = setTimeout(fetchOptions, 500);
+      return () => clearTimeout(timeOutId);
+    }
+
+    return () => {};
+  }, [searchValue]);
+  useEffect(() => {
+    if (searchable && !showDropdownMenu) setSearchValue('');
+
+    if (showDropdownMenu && containerRef?.current && dropdownMenuRef.current) {
+      const dropdownMenuRect = dropdownMenuRef.current.getBoundingClientRect();
+      const containerRect = containerRef.current.getBoundingClientRect();
+
+      if (dropdownMenuRect.bottom > containerRect.bottom) {
+        dropdownMenuRef.current.style.bottom = '40px';
+        dropdownMenuRef.current.style.top = 'auto';
+      } else {
+        dropdownMenuRef.current.style.top = '60px';
+        dropdownMenuRef.current.style.bottom = 'auto';
+      }
+    }
+  }, [showDropdownMenu]);
+
+  // #########
+  // Rendering
+  return (
+    <div className="ts-dropdown-container" ref={dropdownRef}>
+      <div className="ts-dropdown-input-container">
+        {label && <div className="ts-dropdown-label">{label}</div>}
+        <div
+          className={`
+            ts-dropdown-input
+            ${disabled ? 'ts-dropdown-input--disabled' : ''}
+            ${error && error !== '' ? 'ts-dropdown-container--error' : ''}
+          `}
+          onClick={handleShowDropdownMenu}
+        >
+          {!value && placeholder && <div className="ts-dropdown-input--placeholder">{placeholder}</div>}
+          {value && <div className="ts-dropdown-input--value">{getOptionLabel(value)}</div>}
+          <div className="ts-dropdown-input--chevron">
+            <TsIcon name={showDropdownMenu ? 'chevron-up' : 'chevron-down'} />
+          </div>
+        </div>
+      </div>
+
+      {error && error !== '' && (
+        <div className="ts-dropdown-error">
+          <div className="ts-dropdown-error--icon">
+            <TsIcon name="alert-circle" size="16" />
+          </div>
+          <div className="ts-dropdown-error--label">{error}</div>
+        </div>
+      )}
+
+      {!disabled && showDropdownMenu && (
+        <div className="ts-dropdown-menu-container" ref={dropdownMenuRef}>
+          {searchable && (
+            <div className="ts-dropdown-search">
+              <TsInput
+                icon="search"
+                placeholder={searchPlaceholder}
+                value={searchValue}
+                autoFocus
+                onChange={setSearchValue}
+              />
+            </div>
+          )}
+
+          <div className="ts-dropdown-menu">
+            {loading && (
+              <div className="ts-dropdown-menu-loader">
+                <TsLoader size="sm" />
+              </div>
+            )}
+            {!loading && isFetchError && (
+              <div className="ts-dropdown-menu-error-text">An error occured, try again later.</div>
+            )}
+            {!loading && !isFetchError && items.length === 0 && (
+              <div className="ts-dropdown-menu-error-text">No options found.</div>
+            )}
+            {!loading &&
+              !isFetchError &&
+              items.length > 0 &&
+              items.map(item => (
+                <div
+                  key={getOptionValue(item)}
+                  className="ts-dropdown-menu-item"
+                  onClick={() => handleSelectItem(item)}
+                >
+                  {getOptionLabel(item)}
+                </div>
+              ))}
+          </div>
+        </div>
+      )}
+    </div>
+  );
+};

package/esm/components/TsDropdowns/TsDropdown/TsDropdown.types.d.ts

@@ -0,0 +1,17 @@
+import { RefObject } from 'react';
+export type TsDropdownProps<T> = {
+    containerRef?: RefObject<HTMLElement>;
+    error?: string;
+    label?: string;
+    options?: T[];
+    placeholder?: string;
+    reloadOptionsOn?: any[];
+    searchPlaceholder?: string;
+    value?: T;
+    disabled?: boolean;
+    searchable?: boolean;
+    getOptionLabel: (option: T) => string;
+    getOptionValue: (option: T) => string;
+    loadOptions?: (search?: string) => Promise<T[]>;
+    onChange: (value?: T) => void;
+};

package/esm/components/TsDropdowns/TsDropdown/TsDropdown.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TsDropdown.types.js.map

package/esm/components/TsDropdowns/TsDropdown/TsDropdown.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TsDropdown.types.js","sourceRoot":"","sources":["../../../../src/components/TsDropdowns/TsDropdown/TsDropdown.types.ts"],"names":[],"mappings":""}

package/esm/components/TsDropdowns/TsDropdown/TsDropdown.types.ts

@@ -0,0 +1,18 @@
+import { RefObject } from 'react';
+
+export type TsDropdownProps<T> = {
+  containerRef?: RefObject<HTMLElement>;
+  error?: string;
+  label?: string;
+  options?: T[];
+  placeholder?: string;
+  reloadOptionsOn?: any[];
+  searchPlaceholder?: string;
+  value?: T;
+  disabled?: boolean;
+  searchable?: boolean;
+  getOptionLabel: (option: T) => string;
+  getOptionValue: (option: T) => string;
+  loadOptions?: (search?: string) => Promise<T[]>;
+  onChange: (value?: T) => void;
+};

package/esm/components/TsDropdowns/TsDropdown/__stories__/TsDropdown.stories.mdx

@@ -0,0 +1,85 @@
+import React from 'react';
+import { ArgsTable, Canvas, Meta, Story } from '@storybook/blocks';
+import { TsDropdown } from '../TsDropdown';
+import { fruits } from './fruits';
+
+<Meta title="Components/Dropdowns/Dropdown" />
+
+export const dropdownArgTypes = {
+  error: {
+    control: 'text',
+    description: 'Error of the dropdown.',
+  },
+  label: {
+    control: 'text',
+    description: 'Label of the dropdown.',
+  },
+  placeholder: {
+    control: 'text',
+    description: 'Placeholder of the dropdown.',
+  },
+  searchPlaceholder: {
+    control: 'text',
+    description: 'Placeholder of the option search (only for searchable dropdowns).',
+  },
+  searchable: {
+    control: 'boolean',
+    description: 'Enable search on dropdown items.',
+    table: { defaultValue: { summary: 'false' } },
+  },
+  disabled: {
+    control: 'boolean',
+    description: 'Enable state of the dropdown.',
+    table: { defaultValue: { summary: 'false' } },
+  },
+  getOptionLabel: {
+    control: 'function',
+    description: 'The handler called to get the option label',
+  },
+  getOptionValue: {
+    control: 'function',
+    description: 'The handler called to get the option value.',
+  },
+  loadOptions: {
+    control: 'function',
+    description: 'The handler called to fetch all options in async (not available on playground).',
+  },
+  onChange: {
+    control: 'function',
+    description: 'The handler called when clicking on the dropdown option.',
+  },
+};
+
+# Dropdown
+
+Dropdowns show a list of options that can be used to select, filter or sort content.
+
+## Overview
+
+<Canvas>
+  <Story
+    name="Overview"
+    args={{
+      error: '',
+      label: 'Label',
+      options: fruits,
+      searchPlaceholder: '',
+      placeholder: 'Select an item',
+      disabled: false,
+      searchable: false,
+      getOptionLabel: function ol(fruit) {
+        return fruit.name;
+      },
+      getOptionValue: function ov(fruit) {
+        return fruit.id;
+      },
+    }}
+    argTypes={dropdownArgTypes}
+  >
+    {args => <TsDropdown {...args}>{args.children}</TsDropdown>}
+  </Story>
+</Canvas>
+
+## Props
+
+<ArgsTable story="Overview" of={TsDropdown} />

package/esm/components/TsDropdowns/TsDropdown/__stories__/fruits.d.ts

@@ -0,0 +1,4 @@
+export declare const fruits: {
+    name: string;
+    id: number;
+}[];

package/esm/components/TsDropdowns/TsDropdown/__stories__/fruits.js

@@ -0,0 +1,48 @@
+export const fruits = [
+    { name: 'Persimmon', id: 52 },
+    { name: 'Strawberry', id: 3 },
+    { name: 'Banana', id: 1 },
+    { name: 'Tomato', id: 5 },
+    { name: 'Pear', id: 4 },
+    { name: 'Durian', id: 60 },
+    { name: 'Blackberry', id: 64 },
+    { name: 'Lingonberry', id: 65 },
+    { name: 'Kiwi', id: 66 },
+    { name: 'Lychee', id: 67 },
+    { name: 'Pineapple', id: 10 },
+    { name: 'Fig', id: 68 },
+    { name: 'Gooseberry', id: 69 },
+    { name: 'Passionfruit', id: 70 },
+    { name: 'Plum', id: 71 },
+    { name: 'Orange', id: 2 },
+    { name: 'GreenApple', id: 72 },
+    { name: 'Raspberry', id: 23 },
+    { name: 'Watermelon', id: 25 },
+    { name: 'Lemon', id: 26 },
+    { name: 'Mango', id: 27 },
+    { name: 'Blueberry', id: 33 },
+    { name: 'Apple', id: 6 },
+    { name: 'Guava', id: 37 },
+    { name: 'Apricot', id: 35 },
+    { name: 'Papaya', id: 42 },
+    { name: 'Melon', id: 41 },
+    { name: 'Tangerine', id: 77 },
+    { name: 'Pitahaya', id: 78 },
+    { name: 'Lime', id: 44 },
+    { name: 'Pomegranate', id: 79 },
+    { name: 'Dragonfruit', id: 80 },
+    { name: 'Grape', id: 81 },
+    { name: 'Morus', id: 82 },
+    { name: 'Feijoa', id: 76 },
+    { name: 'Avocado', id: 84 },
+    { name: 'Kiwifruit', id: 85 },
+    { name: 'Cranberry', id: 87 },
+    { name: 'Cherry', id: 9 },
+    { name: 'Peach', id: 86 },
+    { name: 'Jackfruit', id: 94 },
+    { name: 'Horned Melon', id: 95 },
+    { name: 'Hazelnut', id: 96 },
+    { name: 'Pomelo', id: 98 },
+    { name: 'Mangosteen', id: 99 },
+];
+//# sourceMappingURL=fruits.js.map

package/esm/components/TsDropdowns/TsDropdown/__stories__/fruits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fruits.js","sourceRoot":"","sources":["../../../../../src/components/TsDropdowns/TsDropdown/__stories__/fruits.ts"],"names":[],"mappings":"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"}

package/esm/components/TsDropdowns/TsDropdown/__stories__/fruits.ts

@@ -0,0 +1,47 @@
+export const fruits = [
+  { name: 'Persimmon', id: 52 },
+  { name: 'Strawberry', id: 3 },
+  { name: 'Banana', id: 1 },
+  { name: 'Tomato', id: 5 },
+  { name: 'Pear', id: 4 },
+  { name: 'Durian', id: 60 },
+  { name: 'Blackberry', id: 64 },
+  { name: 'Lingonberry', id: 65 },
+  { name: 'Kiwi', id: 66 },
+  { name: 'Lychee', id: 67 },
+  { name: 'Pineapple', id: 10 },
+  { name: 'Fig', id: 68 },
+  { name: 'Gooseberry', id: 69 },
+  { name: 'Passionfruit', id: 70 },
+  { name: 'Plum', id: 71 },
+  { name: 'Orange', id: 2 },
+  { name: 'GreenApple', id: 72 },
+  { name: 'Raspberry', id: 23 },
+  { name: 'Watermelon', id: 25 },
+  { name: 'Lemon', id: 26 },
+  { name: 'Mango', id: 27 },
+  { name: 'Blueberry', id: 33 },
+  { name: 'Apple', id: 6 },
+  { name: 'Guava', id: 37 },
+  { name: 'Apricot', id: 35 },
+  { name: 'Papaya', id: 42 },
+  { name: 'Melon', id: 41 },
+  { name: 'Tangerine', id: 77 },
+  { name: 'Pitahaya', id: 78 },
+  { name: 'Lime', id: 44 },
+  { name: 'Pomegranate', id: 79 },
+  { name: 'Dragonfruit', id: 80 },
+  { name: 'Grape', id: 81 },
+  { name: 'Morus', id: 82 },
+  { name: 'Feijoa', id: 76 },
+  { name: 'Avocado', id: 84 },
+  { name: 'Kiwifruit', id: 85 },
+  { name: 'Cranberry', id: 87 },
+  { name: 'Cherry', id: 9 },
+  { name: 'Peach', id: 86 },
+  { name: 'Jackfruit', id: 94 },
+  { name: 'Horned Melon', id: 95 },
+  { name: 'Hazelnut', id: 96 },
+  { name: 'Pomelo', id: 98 },
+  { name: 'Mangosteen', id: 99 },
+];

package/esm/components/TsDropdowns/TsDropdownFilter/TsDropdownFilter.css

@@ -0,0 +1,83 @@
+.ts-dropdown-container {
+  position: relative;
+}
+.ts-dropdown-input {
+  display: flex;
+  height: 32px;
+  padding-left: 16px;
+  padding-right: 12px;
+  background: #e1e3f5;
+  color: #3643ba;
+  cursor: pointer;
+}
+.ts-dropdown-input:hover {
+  background: #d7daf1;
+}
+.ts-dropdown-label {
+  display: flex;
+  align-items: center;
+  height: 32px;
+  margin-right: 2px;
+}
+.ts-dropdown-input--chevron {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  height: 32px;
+}
+.ts-dropdown-menu-container {
+  position: absolute;
+  top: calc(100% + 8px);
+  display: flex;
+  flex-direction: column;
+  width: 320px;
+  max-height: 200px;
+  padding: 12px;
+  box-shadow: 0px 8px 9px 0px #1010101a;
+  background: #ffffff;
+  overflow: hidden;
+  z-index: 10;
+}
+.ts-dropdown-search {
+  padding-bottom: 12px;
+  border-bottom: 1px solid #d9dde1;
+}
+.ts-dropdown-menu-loader {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding-top: 12px;
+}
+.ts-dropdown-menu-error-text {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding-top: 12px;
+  color: #687787;
+  font-style: italic;
+}
+.ts-dropdown-menu {
+  padding-top: 12px;
+  overflow: auto;
+}
+.ts-dropdown-menu-item {
+  display: flex;
+  align-items: center;
+  height: 32px;
+  padding: 0 12px;
+  cursor: pointer;
+}
+.ts-dropdown-menu-item:hover {
+  background: #e1e3f5;
+  color: #3643ba;
+}
+
+/* ######### */
+/* GLOBALS   */
+* {
+  font-size: 14px;
+  outline: none;
+  box-sizing: border-box;
+  font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans',
+    'Helvetica Neue', sans-serif;
+}

package/esm/components/TsDropdowns/TsDropdownFilter/TsDropdownFilter.d.ts

@@ -0,0 +1,4 @@
+import * as React from 'react';
+import { TsDropdownFilterProps } from './TsDropdownFilter.types';
+import './TsDropdownFilter.css';
+export declare const TsDropdownFilter: <T>({ label, searchPlaceholder, loadOptions, getOptionLabel, getOptionValue, onChange, }: TsDropdownFilterProps<T>) => React.JSX.Element;

package/esm/components/TsDropdowns/TsDropdownFilter/TsDropdownFilter.js

@@ -0,0 +1,62 @@
+import * as React from 'react';
+import { useEffect, useState } from 'react';
+import { useClickOutside } from '../../../hooks/use-click-outside';
+import { capitalize } from '../../../utils/string.utils';
+import { TsIcon } from '../../TsIcon/TsIcon';
+import { TsInput } from '../../TsInput/TsInput/TsInput';
+import { TsLoader } from '../../TsLoader/TsLoader';
+import './TsDropdownFilter.css';
+export const TsDropdownFilter = ({ label, searchPlaceholder, loadOptions, getOptionLabel, getOptionValue, onChange, }) => {
+    const [searchValue, setSearchValue] = useState('');
+    const [showDropdown, setShowDropdown] = useState(false);
+    const [items, setItems] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const ref = useClickOutside(() => setShowDropdown(false));
+    // ########
+    // Fetchers
+    const fetchAllItems = () => {
+        return loadOptions(searchValue)
+            .then(setItems)
+            .catch(() => { }); // TODO: Manage fetch ERRORS (Show an error message : 'An error occured, please retry later' or something else)
+    };
+    // ########
+    // Handlers
+    const handleSelectItem = (value) => {
+        onChange(value);
+        setShowDropdown(false);
+    };
+    // ########
+    // Watchers
+    useEffect(() => {
+        if (!showDropdown)
+            setSearchValue('');
+    }, [showDropdown]);
+    useEffect(() => {
+        setLoading(true);
+        if (!searchValue) {
+            fetchAllItems().finally(() => setLoading(false));
+        }
+        else {
+            const timeOutId = setTimeout(() => {
+                fetchAllItems().finally(() => setLoading(false));
+            }, 500);
+            return () => clearTimeout(timeOutId);
+        }
+        return;
+    }, [searchValue]);
+    // #########
+    // Rendering
+    return (React.createElement("div", { className: "ts-dropdown-container", ref: ref },
+        React.createElement("div", { className: "ts-dropdown-input", onClick: () => setShowDropdown(!showDropdown) },
+            React.createElement("div", { className: "ts-dropdown-label" }, label),
+            React.createElement("div", { className: "ts-dropdown-input--chevron" },
+                React.createElement(TsIcon, { name: showDropdown ? 'chevron-up' : 'chevron-down' }))),
+        showDropdown && (React.createElement("div", { className: "ts-dropdown-menu-container" },
+            React.createElement("div", { className: "ts-dropdown-search" },
+                React.createElement(TsInput, { icon: "search", placeholder: searchPlaceholder, value: searchValue, autoFocus: true, onChange: setSearchValue })),
+            loading && (React.createElement("div", { className: "ts-dropdown-menu-loader" },
+                React.createElement(TsLoader, { size: "sm" }))),
+            !loading && items.length === 0 && React.createElement("div", { className: "ts-dropdown-menu-error-text" }, "Nothing found."),
+            !loading && items.length > 0 && (React.createElement("div", { className: "ts-dropdown-menu" }, items.map(item => (React.createElement("div", { key: getOptionValue(item), className: "ts-dropdown-menu-item", onClick: () => handleSelectItem(item) }, capitalize(getOptionLabel(item)))))))))));
+};
+//# sourceMappingURL=TsDropdownFilter.js.map

package/esm/components/TsDropdowns/TsDropdownFilter/TsDropdownFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TsDropdownFilter.js","sourceRoot":"","sources":["../../../../src/components/TsDropdowns/TsDropdownFilter/TsDropdownFilter.tsx"],"names":[],"mappings":"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"}

package/esm/components/TsDropdowns/TsDropdownFilter/TsDropdownFilter.tsx

@@ -0,0 +1,105 @@
+import * as React from 'react';
+import { useEffect, useState } from 'react';
+import { useClickOutside } from '../../../hooks/use-click-outside';
+import { capitalize } from '../../../utils/string.utils';
+import { TsIcon } from '../../TsIcon/TsIcon';
+import { TsInput } from '../../TsInput/TsInput/TsInput';
+import { TsLoader } from '../../TsLoader/TsLoader';
+import { TsDropdownFilterProps } from './TsDropdownFilter.types';
+import './TsDropdownFilter.css';
+
+export const TsDropdownFilter = <T,>({
+  label,
+  searchPlaceholder,
+  loadOptions,
+  getOptionLabel,
+  getOptionValue,
+  onChange,
+}: TsDropdownFilterProps<T>) => {
+  const [searchValue, setSearchValue] = useState<string>('');
+  const [showDropdown, setShowDropdown] = useState<boolean>(false);
+  const [items, setItems] = useState<T[]>([]);
+  const [loading, setLoading] = useState<boolean>(true);
+  const ref = useClickOutside(() => setShowDropdown(false));
+
+  // ########
+  // Fetchers
+  const fetchAllItems = () => {
+    return loadOptions(searchValue)
+      .then(setItems)
+      .catch(() => {}); // TODO: Manage fetch ERRORS (Show an error message : 'An error occured, please retry later' or something else)
+  };
+
+  // ########
+  // Handlers
+  const handleSelectItem = (value: T) => {
+    onChange(value);
+    setShowDropdown(false);
+  };
+
+  // ########
+  // Watchers
+  useEffect(() => {
+    if (!showDropdown) setSearchValue('');
+  }, [showDropdown]);
+  useEffect(() => {
+    setLoading(true);
+
+    if (!searchValue) {
+      fetchAllItems().finally(() => setLoading(false));
+    } else {
+      const timeOutId = setTimeout(() => {
+        fetchAllItems().finally(() => setLoading(false));
+      }, 500);
+      return () => clearTimeout(timeOutId);
+    }
+    return;
+  }, [searchValue]);
+
+  // #########
+  // Rendering
+  return (
+    <div className="ts-dropdown-container" ref={ref}>
+      <div className="ts-dropdown-input" onClick={() => setShowDropdown(!showDropdown)}>
+        <div className="ts-dropdown-label">{label}</div>
+        <div className="ts-dropdown-input--chevron">
+          <TsIcon name={showDropdown ? 'chevron-up' : 'chevron-down'} />
+        </div>
+      </div>
+
+      {showDropdown && (
+        <div className="ts-dropdown-menu-container">
+          <div className="ts-dropdown-search">
+            <TsInput
+              icon="search"
+              placeholder={searchPlaceholder}
+              value={searchValue}
+              autoFocus
+              onChange={setSearchValue}
+            />
+          </div>
+
+          {loading && (
+            <div className="ts-dropdown-menu-loader">
+              <TsLoader size="sm" />
+            </div>
+          )}
+          {!loading && items.length === 0 && <div className="ts-dropdown-menu-error-text">Nothing found.</div>}
+          {!loading && items.length > 0 && (
+            <div className="ts-dropdown-menu">
+              {items.map(item => (
+                <div
+                  key={getOptionValue(item)}
+                  className="ts-dropdown-menu-item"
+                  onClick={() => handleSelectItem(item)}
+                >
+                  {capitalize(getOptionLabel(item))}
+                </div>
+              ))}
+            </div>
+          )}
+        </div>
+      )}
+    </div>
+  );
+};

package/esm/components/TsDropdowns/TsDropdownFilter/TsDropdownFilter.types.d.ts

@@ -0,0 +1,8 @@
+export type TsDropdownFilterProps<T> = {
+    label: string;
+    searchPlaceholder?: string;
+    loadOptions: (query?: string) => Promise<T[]>;
+    getOptionLabel: (item: T) => string;
+    getOptionValue: (item: T) => string;
+    onChange: (item: T) => void;
+};