@sanity/ui 0.36.13 → 0.36.16

package/src/components/autocomplete/__fixtures__/countries.ts

@@ -0,0 +1,245 @@
+export default [
+  {name: 'Afghanistan', code: 'AF'},
+  {name: 'Åland Islands', code: 'AX'},
+  {name: 'Albania', code: 'AL'},
+  {name: 'Algeria', code: 'DZ'},
+  {name: 'American Samoa', code: 'AS'},
+  {name: 'Andorra', code: 'AD'},
+  {name: 'Angola', code: 'AO'},
+  {name: 'Anguilla', code: 'AI'},
+  {name: 'Antarctica', code: 'AQ'},
+  {name: 'Antigua and Barbuda', code: 'AG'},
+  {name: 'Argentina', code: 'AR'},
+  {name: 'Armenia', code: 'AM'},
+  {name: 'Aruba', code: 'AW'},
+  {name: 'Australia', code: 'AU'},
+  {name: 'Austria', code: 'AT'},
+  {name: 'Azerbaijan', code: 'AZ'},
+  {name: 'Bahamas', code: 'BS'},
+  {name: 'Bahrain', code: 'BH'},
+  {name: 'Bangladesh', code: 'BD'},
+  {name: 'Barbados', code: 'BB'},
+  {name: 'Belarus', code: 'BY'},
+  {name: 'Belgium', code: 'BE'},
+  {name: 'Belize', code: 'BZ'},
+  {name: 'Benin', code: 'BJ'},
+  {name: 'Bermuda', code: 'BM'},
+  {name: 'Bhutan', code: 'BT'},
+  {name: 'Bolivia', code: 'BO'},
+  {name: 'Bosnia and Herzegovina', code: 'BA'},
+  {name: 'Botswana', code: 'BW'},
+  {name: 'Bouvet Island', code: 'BV'},
+  {name: 'Brazil', code: 'BR'},
+  {name: 'British Indian Ocean Territory', code: 'IO'},
+  {name: 'Brunei Darussalam', code: 'BN'},
+  {name: 'Bulgaria', code: 'BG'},
+  {name: 'Burkina Faso', code: 'BF'},
+  {name: 'Burundi', code: 'BI'},
+  {name: 'Cambodia', code: 'KH'},
+  {name: 'Cameroon', code: 'CM'},
+  {name: 'Canada', code: 'CA'},
+  {name: 'Cape Verde', code: 'CV'},
+  {name: 'Cayman Islands', code: 'KY'},
+  {name: 'Central African Republic', code: 'CF'},
+  {name: 'Chad', code: 'TD'},
+  {name: 'Chile', code: 'CL'},
+  {name: 'China', code: 'CN'},
+  {name: 'Christmas Island', code: 'CX'},
+  {name: 'Cocos (Keeling) Islands', code: 'CC'},
+  {name: 'Colombia', code: 'CO'},
+  {name: 'Comoros', code: 'KM'},
+  {name: 'Congo', code: 'CG'},
+  {name: 'Congo, The Democratic Republic of the', code: 'CD'},
+  {name: 'Cook Islands', code: 'CK'},
+  {name: 'Costa Rica', code: 'CR'},
+  {name: "Cote D'Ivoire", code: 'CI'},
+  {name: 'Croatia', code: 'HR'},
+  {name: 'Cuba', code: 'CU'},
+  {name: 'Cyprus', code: 'CY'},
+  {name: 'Czech Republic', code: 'CZ'},
+  {name: 'Denmark', code: 'DK'},
+  {name: 'Djibouti', code: 'DJ'},
+  {name: 'Dominica', code: 'DM'},
+  {name: 'Dominican Republic', code: 'DO'},
+  {name: 'Ecuador', code: 'EC'},
+  {name: 'Egypt', code: 'EG'},
+  {name: 'El Salvador', code: 'SV'},
+  {name: 'Equatorial Guinea', code: 'GQ'},
+  {name: 'Eritrea', code: 'ER'},
+  {name: 'Estonia', code: 'EE'},
+  {name: 'Ethiopia', code: 'ET'},
+  {name: 'Falkland Islands (Malvinas)', code: 'FK'},
+  {name: 'Faroe Islands', code: 'FO'},
+  {name: 'Fiji', code: 'FJ'},
+  {name: 'Finland', code: 'FI'},
+  {name: 'France', code: 'FR'},
+  {name: 'French Guiana', code: 'GF'},
+  {name: 'French Polynesia', code: 'PF'},
+  {name: 'French Southern Territories', code: 'TF'},
+  {name: 'Gabon', code: 'GA'},
+  {name: 'Gambia', code: 'GM'},
+  {name: 'Georgia', code: 'GE'},
+  {name: 'Germany', code: 'DE'},
+  {name: 'Ghana', code: 'GH'},
+  {name: 'Gibraltar', code: 'GI'},
+  {name: 'Greece', code: 'GR'},
+  {name: 'Greenland', code: 'GL'},
+  {name: 'Grenada', code: 'GD'},
+  {name: 'Guadeloupe', code: 'GP'},
+  {name: 'Guam', code: 'GU'},
+  {name: 'Guatemala', code: 'GT'},
+  {name: 'Guernsey', code: 'GG'},
+  {name: 'Guinea', code: 'GN'},
+  {name: 'Guinea-Bissau', code: 'GW'},
+  {name: 'Guyana', code: 'GY'},
+  {name: 'Haiti', code: 'HT'},
+  {name: 'Heard Island and Mcdonald Islands', code: 'HM'},
+  {name: 'Holy See (Vatican City State)', code: 'VA'},
+  {name: 'Honduras', code: 'HN'},
+  {name: 'Hong Kong', code: 'HK'},
+  {name: 'Hungary', code: 'HU'},
+  {name: 'Iceland', code: 'IS'},
+  {name: 'India', code: 'IN'},
+  {name: 'Indonesia', code: 'ID'},
+  {name: 'Iran, Islamic Republic Of', code: 'IR'},
+  {name: 'Iraq', code: 'IQ'},
+  {name: 'Ireland', code: 'IE'},
+  {name: 'Isle of Man', code: 'IM'},
+  {name: 'Israel', code: 'IL'},
+  {name: 'Italy', code: 'IT'},
+  {name: 'Jamaica', code: 'JM'},
+  {name: 'Japan', code: 'JP'},
+  {name: 'Jersey', code: 'JE'},
+  {name: 'Jordan', code: 'JO'},
+  {name: 'Kazakhstan', code: 'KZ'},
+  {name: 'Kenya', code: 'KE'},
+  {name: 'Kiribati', code: 'KI'},
+  {name: "Korea, Democratic People'S Republic of", code: 'KP'},
+  {name: 'Korea, Republic of', code: 'KR'},
+  {name: 'Kuwait', code: 'KW'},
+  {name: 'Kyrgyzstan', code: 'KG'},
+  {name: "Lao People'S Democratic Republic", code: 'LA'},
+  {name: 'Latvia', code: 'LV'},
+  {name: 'Lebanon', code: 'LB'},
+  {name: 'Lesotho', code: 'LS'},
+  {name: 'Liberia', code: 'LR'},
+  {name: 'Libyan Arab Jamahiriya', code: 'LY'},
+  {name: 'Liechtenstein', code: 'LI'},
+  {name: 'Lithuania', code: 'LT'},
+  {name: 'Luxembourg', code: 'LU'},
+  {name: 'Macao', code: 'MO'},
+  {name: 'Macedonia, The Former Yugoslav Republic of', code: 'MK'},
+  {name: 'Madagascar', code: 'MG'},
+  {name: 'Malawi', code: 'MW'},
+  {name: 'Malaysia', code: 'MY'},
+  {name: 'Maldives', code: 'MV'},
+  {name: 'Mali', code: 'ML'},
+  {name: 'Malta', code: 'MT'},
+  {name: 'Marshall Islands', code: 'MH'},
+  {name: 'Martinique', code: 'MQ'},
+  {name: 'Mauritania', code: 'MR'},
+  {name: 'Mauritius', code: 'MU'},
+  {name: 'Mayotte', code: 'YT'},
+  {name: 'Mexico', code: 'MX'},
+  {name: 'Micronesia, Federated States of', code: 'FM'},
+  {name: 'Moldova, Republic of', code: 'MD'},
+  {name: 'Monaco', code: 'MC'},
+  {name: 'Mongolia', code: 'MN'},
+  {name: 'Montserrat', code: 'MS'},
+  {name: 'Morocco', code: 'MA'},
+  {name: 'Mozambique', code: 'MZ'},
+  {name: 'Myanmar', code: 'MM'},
+  {name: 'Namibia', code: 'NA'},
+  {name: 'Nauru', code: 'NR'},
+  {name: 'Nepal', code: 'NP'},
+  {name: 'Netherlands', code: 'NL'},
+  {name: 'Netherlands Antilles', code: 'AN'},
+  {name: 'New Caledonia', code: 'NC'},
+  {name: 'New Zealand', code: 'NZ'},
+  {name: 'Nicaragua', code: 'NI'},
+  {name: 'Niger', code: 'NE'},
+  {name: 'Nigeria', code: 'NG'},
+  {name: 'Niue', code: 'NU'},
+  {name: 'Norfolk Island', code: 'NF'},
+  {name: 'Northern Mariana Islands', code: 'MP'},
+  {name: 'Norway', code: 'NO'},
+  {name: 'Oman', code: 'OM'},
+  {name: 'Pakistan', code: 'PK'},
+  {name: 'Palau', code: 'PW'},
+  {name: 'Palestinian Territory, Occupied', code: 'PS'},
+  {name: 'Panama', code: 'PA'},
+  {name: 'Papua New Guinea', code: 'PG'},
+  {name: 'Paraguay', code: 'PY'},
+  {name: 'Peru', code: 'PE'},
+  {name: 'Philippines', code: 'PH'},
+  {name: 'Pitcairn', code: 'PN'},
+  {name: 'Poland', code: 'PL'},
+  {name: 'Portugal', code: 'PT'},
+  {name: 'Puerto Rico', code: 'PR'},
+  {name: 'Qatar', code: 'QA'},
+  {name: 'Reunion', code: 'RE'},
+  {name: 'Romania', code: 'RO'},
+  {name: 'Russian Federation', code: 'RU'},
+  {name: 'RWANDA', code: 'RW'},
+  {name: 'Saint Helena', code: 'SH'},
+  {name: 'Saint Kitts and Nevis', code: 'KN'},
+  {name: 'Saint Lucia', code: 'LC'},
+  {name: 'Saint Pierre and Miquelon', code: 'PM'},
+  {name: 'Saint Vincent and the Grenadines', code: 'VC'},
+  {name: 'Samoa', code: 'WS'},
+  {name: 'San Marino', code: 'SM'},
+  {name: 'Sao Tome and Principe', code: 'ST'},
+  {name: 'Saudi Arabia', code: 'SA'},
+  {name: 'Senegal', code: 'SN'},
+  {name: 'Serbia and Montenegro', code: 'CS'},
+  {name: 'Seychelles', code: 'SC'},
+  {name: 'Sierra Leone', code: 'SL'},
+  {name: 'Singapore', code: 'SG'},
+  {name: 'Slovakia', code: 'SK'},
+  {name: 'Slovenia', code: 'SI'},
+  {name: 'Solomon Islands', code: 'SB'},
+  {name: 'Somalia', code: 'SO'},
+  {name: 'South Africa', code: 'ZA'},
+  {name: 'South Georgia and the South Sandwich Islands', code: 'GS'},
+  {name: 'Spain', code: 'ES'},
+  {name: 'Sri Lanka', code: 'LK'},
+  {name: 'Sudan', code: 'SD'},
+  {name: 'Suriname', code: 'SR'},
+  {name: 'Svalbard and Jan Mayen', code: 'SJ'},
+  {name: 'Swaziland', code: 'SZ'},
+  {name: 'Sweden', code: 'SE'},
+  {name: 'Switzerland', code: 'CH'},
+  {name: 'Syrian Arab Republic', code: 'SY'},
+  {name: 'Taiwan, Province of China', code: 'TW'},
+  {name: 'Tajikistan', code: 'TJ'},
+  {name: 'Tanzania, United Republic of', code: 'TZ'},
+  {name: 'Thailand', code: 'TH'},
+  {name: 'Timor-Leste', code: 'TL'},
+  {name: 'Togo', code: 'TG'},
+  {name: 'Tokelau', code: 'TK'},
+  {name: 'Tonga', code: 'TO'},
+  {name: 'Trinidad and Tobago', code: 'TT'},
+  {name: 'Tunisia', code: 'TN'},
+  {name: 'Turkey', code: 'TR'},
+  {name: 'Turkmenistan', code: 'TM'},
+  {name: 'Turks and Caicos Islands', code: 'TC'},
+  {name: 'Tuvalu', code: 'TV'},
+  {name: 'Uganda', code: 'UG'},
+  {name: 'Ukraine', code: 'UA'},
+  {name: 'United Arab Emirates', code: 'AE'},
+  {name: 'United Kingdom', code: 'GB'},
+  {name: 'United States', code: 'US'},
+  {name: 'United States Minor Outlying Islands', code: 'UM'},
+  {name: 'Uruguay', code: 'UY'},
+  {name: 'Uzbekistan', code: 'UZ'},
+  {name: 'Vanuatu', code: 'VU'},
+  {name: 'Venezuela', code: 'VE'},
+  {name: 'Viet Nam', code: 'VN'},
+  {name: 'Virgin Islands, British', code: 'VG'},
+  {name: 'Virgin Islands, U.S.', code: 'VI'},
+  {name: 'Wallis and Futuna', code: 'WF'},
+  {name: 'Western Sahara', code: 'EH'},
+  {name: 'Yemen', code: 'YE'},
+  {name: 'Zambia', code: 'ZM'},
+  {name: 'Zimbabwe', code: 'ZW'},
+]

package/src/components/autocomplete/__mocks__/apiStore.ts

@@ -0,0 +1,49 @@
+import countries from '../__fixtures__/countries'
+
+export const countriesStore = {
+  search(
+    query: string,
+    onResults: (results: {value: string}[]) => void,
+    onLoading: (flag: boolean) => void
+  ): {cancel: () => void} {
+    const fakeDelay = 350 + Math.random() * 800
+
+    onLoading(true)
+
+    const timeout = setTimeout(() => {
+      const results: {value: string}[] = countries
+        .filter((d) => d.name.toLowerCase().includes(query.toLowerCase()))
+        .map((d) => ({value: d.code}))
+
+      onResults(results)
+      onLoading(false)
+    }, fakeDelay)
+
+    return {
+      cancel: () => clearTimeout(timeout),
+    }
+  },
+
+  fetchDocument(
+    id: string,
+    onResult: (value: {code: string; title: string} | null) => void,
+    onLoading: (flag: boolean) => void
+  ): {cancel: () => void} {
+    const fakeDelay = 50 + Math.random() * 400
+
+    onLoading(true)
+
+    const timeout = setTimeout(() => {
+      const rec = countries.find((c) => c.code === id)
+
+      const doc = rec && {code: rec.code, title: rec.name}
+
+      onResult(doc || null)
+      onLoading(false)
+    }, fakeDelay)
+
+    return {
+      cancel: () => clearTimeout(timeout),
+    }
+  },
+}

package/src/components/autocomplete/__workshop__/.eslintrc

@@ -0,0 +1,5 @@
+{
+  "rules": {
+    "@typescript-eslint/explicit-module-boundary-types": "off"
+  }
+}

package/src/components/autocomplete/__workshop__/async.tsx

@@ -0,0 +1,152 @@
+import {LinkIcon} from '@sanity/icons'
+import {
+  Autocomplete,
+  BaseAutocompleteOption,
+  Box,
+  Button,
+  Card,
+  Code,
+  LayerProvider,
+  Stack,
+  Text,
+} from '@sanity/ui'
+import React, {useCallback, useEffect, useRef, useState} from 'react'
+import {countriesStore} from '../__mocks__/apiStore'
+
+export default function AsyncStory() {
+  const [options, setOptions] = useState<BaseAutocompleteOption[]>([])
+  const [loading, setLoading] = useState(false)
+  const searchRef = useRef<{cancel: () => void} | null>(null)
+  const fetchRef = useRef<{cancel: () => void} | null>(null)
+  const [query, setQuery] = useState<string | null>(null)
+  const [value, setValue] = useState('')
+  const [optionTitle, setOptionTitle] = useState<string | null>(null)
+  const [loadingCurrentRef, setLoadingCurrentRef] = useState(false)
+
+  const doSearch = useCallback((query: string | null) => {
+    if (searchRef.current) searchRef.current.cancel()
+    searchRef.current = countriesStore.search(query || '', setOptions, setLoading)
+  }, [])
+
+  const filterOption = useCallback(() => true, [])
+
+  const handleQueryChange = useCallback(
+    (query: string | null) => {
+      setQuery(query)
+
+      if (query !== null) {
+        doSearch(query)
+      }
+    },
+    [doSearch]
+  )
+
+  const handleOpenButtonClick = useCallback(() => {
+    if (!value) {
+      doSearch('')
+    }
+  }, [doSearch, value])
+
+  const renderValue = useCallback(() => {
+    if (loadingCurrentRef) {
+      return 'Loading…'
+    }
+
+    return optionTitle || ''
+  }, [loadingCurrentRef, optionTitle])
+
+  const renderOption = useCallback((option: BaseAutocompleteOption) => {
+    return <AsyncOption documentId={option.value} />
+  }, [])
+
+  useEffect(() => {
+    if (fetchRef.current) fetchRef.current.cancel()
+
+    if (value) {
+      fetchRef.current = countriesStore.fetchDocument(
+        value,
+        (data) => setOptionTitle(data?.title || null),
+        setLoadingCurrentRef
+      )
+    } else {
+      setOptionTitle(null)
+      setLoadingCurrentRef(false)
+    }
+  }, [value])
+
+  useEffect(() => {
+    if (optionTitle) doSearch(optionTitle)
+  }, [doSearch, optionTitle])
+
+  return (
+    <Box padding={[4, 5, 6]}>
+      <Stack space={3}>
+        <Text as="label" htmlFor="async" size={1} weight="semibold">
+          Country
+        </Text>
+        <LayerProvider zOffset={100}>
+          <Autocomplete
+            disabled={loadingCurrentRef}
+            filterOption={filterOption}
+            id="async"
+            loading={loading}
+            onChange={setValue}
+            onQueryChange={handleQueryChange}
+            openButton={{onClick: handleOpenButtonClick}}
+            options={options}
+            placeholder="Search"
+            prefix={
+              <Box padding={1}>
+                <Button disabled={!value} icon={LinkIcon} mode="bleed" padding={2} />
+              </Box>
+            }
+            radius={1}
+            renderOption={renderOption}
+            renderValue={renderValue}
+            value={value}
+          />
+        </LayerProvider>
+
+        <Card border overflow="auto" padding={3} radius={1}>
+          <Code language="json">{JSON.stringify({loading, options, query, value}, null, 2)}</Code>
+        </Card>
+      </Stack>
+    </Box>
+  )
+}
+
+function AsyncOption(props: {
+  documentId: string
+  disabled?: boolean
+  selected?: boolean
+  tabIndex?: number
+}) {
+  const {documentId, disabled, selected, tabIndex} = props
+  const [data, setData] = useState<{title: string} | null>(null)
+  const [loading, setLoading] = useState(false)
+  const ref = useRef<{cancel: () => void} | null>(null)
+
+  useEffect(() => {
+    if (ref.current) ref.current.cancel()
+    ref.current = countriesStore.fetchDocument(documentId, setData, setLoading)
+  }, [documentId])
+
+  return (
+    <Card
+      data-as="button"
+      disabled={disabled}
+      padding={3}
+      radius={1}
+      selected={selected}
+      tabIndex={tabIndex}
+    >
+      {loading && (
+        <Text muted>
+          <>Loading…</>
+        </Text>
+      )}
+
+      {!loading && <Text muted={!data}>{data ? data.title : <>Untitled</>}</Text>}
+    </Card>
+  )
+}

package/src/components/autocomplete/__workshop__/constrainedHeight.tsx

@@ -0,0 +1,95 @@
+import {
+  Autocomplete,
+  BoundaryElementProvider,
+  Box,
+  Card,
+  LayerProvider,
+  Stack,
+  Text,
+} from '@sanity/ui'
+import React, {useCallback, useState} from 'react'
+import countries from '../__fixtures__/countries'
+import {ExampleOption} from './types'
+
+export default function ConstrainedHeightStory() {
+  const [boundaryElement, setBoundaryElement] = useState<HTMLDivElement | null>(null)
+
+  return (
+    <Card height="fill" tone="transparent">
+      <Card
+        ref={setBoundaryElement}
+        radius={3}
+        shadow={3}
+        style={{position: 'absolute', top: 20, right: 20, bottom: 20, left: 20}}
+      >
+        <Box height="fill" overflow="auto" padding={[3, 4, 5]} sizing="border">
+          <Stack space={5}>
+            <BoundaryElementProvider element={boundaryElement}>
+              <ConstrainedHeightExampleField id="example-1" label="Example 1" />
+              <ConstrainedHeightExampleField id="example-2" label="Example 2" />
+              <ConstrainedHeightExampleField id="example-3" label="Example 3" />
+              <ConstrainedHeightExampleField id="example-4" label="Example 4" />
+              <ConstrainedHeightExampleField id="example-5" label="Example 5" />
+              <ConstrainedHeightExampleField id="example-6" label="Example 6" />
+              <ConstrainedHeightExampleField id="example-7" label="Example 7" />
+              <ConstrainedHeightExampleField id="example-8" label="Example 8" />
+              <ConstrainedHeightExampleField id="example-9" label="Example 9" />
+            </BoundaryElementProvider>
+          </Stack>
+        </Box>
+      </Card>
+    </Card>
+  )
+}
+
+function ConstrainedHeightExampleField({id, label}: {id: string; label: string}) {
+  const [value, setValue] = useState('')
+
+  const renderOption = useCallback((option: ExampleOption) => {
+    return (
+      <Card
+        as="a"
+        data-qa={`option-${option.value}`}
+        href="#"
+        key={option.value}
+        onClick={(event) => event.preventDefault()}
+        padding={3}
+        radius={2}
+      >
+        <Text textOverflow="ellipsis">{option.title}</Text>
+      </Card>
+    )
+  }, [])
+
+  const renderValue = useCallback((currentValue: string, option?: ExampleOption) => {
+    return option ? option.title : currentValue
+  }, [])
+
+  const filterOption = useCallback((query: string, option: ExampleOption) => {
+    return option.title.toLowerCase().indexOf(query.toLowerCase()) > -1
+  }, [])
+
+  const options = countries.map((item) => ({value: item.code, title: item.name}))
+
+  return (
+    <Stack space={3}>
+      <Text size={1} weight="medium">
+        {label}
+      </Text>
+      <LayerProvider zOffset={100}>
+        <Autocomplete
+          filterOption={filterOption}
+          id={id}
+          onChange={setValue}
+          openButton
+          options={options}
+          placeholder="Search"
+          radius={1}
+          renderOption={renderOption}
+          renderValue={renderValue}
+          value={value}
+        />
+      </LayerProvider>
+    </Stack>
+  )
+}

package/src/components/autocomplete/__workshop__/custom.tsx

@@ -0,0 +1,77 @@
+import {Autocomplete, Box, Button, Card, Code, Stack, Text} from '@sanity/ui'
+import {useBoolean, useSelect} from '@sanity/ui-workshop'
+import React, {useCallback, useState} from 'react'
+import {WORKSHOP_RADIUS_OPTIONS, WORKSHOP_TEXT_SIZE_OPTIONS} from '../../../__workshop__/constants'
+import countries from '../__fixtures__/countries'
+import {ExampleOption} from './types'
+
+export default function CustomStory() {
+  const data: ExampleOption[] = countries.map((d) => ({value: d.code, title: d.name}))
+  const border = useBoolean('Border', true, 'Props')
+  const disabled = useBoolean('Disabled', false, 'Props')
+  const fontSize = Number(useSelect('Font size', WORKSHOP_TEXT_SIZE_OPTIONS, 2, 'Props'))
+  const openButton = useBoolean('Open button', true, 'Props')
+  const radius = Number(useSelect('Radius', WORKSHOP_RADIUS_OPTIONS, 2, 'Props'))
+  const readOnly = useBoolean('Read only', false, 'Props')
+  const [value, setValue] = useState('')
+
+  const renderOption = useCallback(
+    (option: ExampleOption) => (
+      <Card
+        as="a"
+        data-qa={`option-${option.value}`}
+        href="#"
+        key={option.value}
+        onClick={(event) => event.preventDefault()}
+        padding={3}
+        radius={radius - 1}
+      >
+        <Text>{option.title}</Text>
+      </Card>
+    ),
+    [radius]
+  )
+
+  const renderValue = useCallback((currentValue: string, option?: ExampleOption) => {
+    return option ? option.title : currentValue
+  }, [])
+
+  const filterOption = useCallback((query: string, option: ExampleOption) => {
+    return option.title.toLowerCase().indexOf(query.toLowerCase()) > -1
+  }, [])
+
+  const options = data.map((item) => ({value: item.value, title: item.title}))
+
+  return (
+    <Box padding={[4, 5, 6]}>
+      <Stack space={3}>
+        <Text as="label" htmlFor="custom" id="custom-label" size={1} weight="semibold">
+          Country
+        </Text>
+        <Autocomplete
+          aria-describedby="custom-label"
+          border={border}
+          disabled={disabled}
+          filterOption={filterOption}
+          fontSize={fontSize}
+          id="custom"
+          onChange={setValue}
+          openButton={openButton}
+          options={options}
+          placeholder="Search"
+          radius={radius}
+          readOnly={readOnly}
+          renderOption={renderOption}
+          renderValue={renderValue}
+          value={value}
+        />
+        <Card padding={3} radius={1} tone="transparent">
+          <Code>{JSON.stringify(value)}</Code>
+        </Card>
+        <Box>
+          <Button id="set-value-btn" onClick={() => setValue('NO')} text="Set to NO" />
+        </Box>
+      </Stack>
+    </Box>
+  )
+}

package/src/components/autocomplete/__workshop__/example.tsx

@@ -0,0 +1,55 @@
+import {Autocomplete, Box, Card, Container, Stack, Text} from '@sanity/ui'
+import {useBoolean, useSelect, useText} from '@sanity/ui-workshop'
+import React, {useCallback, useMemo, useState} from 'react'
+import {
+  WORKSHOP_CARD_TONE_OPTIONS,
+  WORKSHOP_RADIUS_OPTIONS,
+  WORKSHOP_SPACE_OPTIONS,
+  WORKSHOP_TEXT_SIZE_OPTIONS,
+} from '../../../__workshop__/constants'
+import countries from '../__fixtures__/countries'
+
+export default function ExampleStory() {
+  const layoutTone = useSelect('Layout tone', WORKSHOP_CARD_TONE_OPTIONS, 'default', 'Layout')
+  const options = useMemo(() => countries.map((country) => ({value: country.code})), [])
+  const border = useBoolean('Border', true, 'Props')
+  const customValidity = useText('Custom validity', '', 'Props') || undefined
+  const disabled = useBoolean('Disabled', false, 'Props')
+  const fontSize = Number(useSelect('Font size', WORKSHOP_TEXT_SIZE_OPTIONS, 2, 'Props'))
+  const openButton = useBoolean('Open button', false, 'Props')
+  const padding = useSelect('Padding', WORKSHOP_SPACE_OPTIONS, 3, 'Props')
+  const radius = Number(useSelect('Radius', WORKSHOP_RADIUS_OPTIONS, 2, 'Props'))
+  const readOnly = useBoolean('Read only', false, 'Props')
+  const [value, setValue] = useState('')
+
+  const handleChange = useCallback((value: string) => setValue(value), [])
+
+  return (
+    <Card height="fill" tone={layoutTone}>
+      <Container width={1}>
+        <Box padding={[3, 4, 5]}>
+          <Stack space={3}>
+            <Text as="label" htmlFor="default" size={1} weight="semibold">
+              Country code
+            </Text>
+            <Autocomplete
+              border={border}
+              customValidity={customValidity}
+              disabled={disabled}
+              fontSize={fontSize}
+              onChange={handleChange}
+              id="default"
+              openButton={openButton}
+              options={options}
+              padding={padding}
+              placeholder="Search"
+              radius={radius}
+              readOnly={readOnly}
+              value={value}
+            />
+          </Stack>
+        </Box>
+      </Container>
+    </Card>
+  )
+}