@sanity/ui 0.37.3 → 0.37.4

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>
+  )
+}

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

@@ -0,0 +1,34 @@
+import {Autocomplete, Box, Button, Card, Code, Stack} from '@sanity/ui'
+import React, {useCallback, useState} from 'react'
+
+export default function FocusAndBlurStory() {
+  const [value, setValue] = useState('')
+  const [log, setLog] = useState<string[]>([])
+  const handleBlur = useCallback(() => setLog((v) => v.concat(['blur'])), [])
+  const handleFocus = useCallback(() => setLog((v) => v.concat(['focus'])), [])
+  const handleClear = useCallback(() => setLog([]), [])
+
+  return (
+    <Box padding={[4, 5, 6]}>
+      <Stack space={3}>
+        <Autocomplete
+          id="focus-and-blur"
+          onBlur={handleBlur}
+          onChange={setValue}
+          onFocus={handleFocus}
+          openButton
+          options={[{value: 'foo'}, {value: 'bar'}]}
+          placeholder="Search"
+          value={value}
+        />
+        <Stack space={1}>
+          <Card overflow="auto" padding={3} radius={2} tone="transparent">
+            <Code id="focus-and-blur-log">{JSON.stringify(log)}</Code>
+          </Card>
+
+          <Button id="focus-and-blur-clear-btn" onClick={handleClear} text="Clear" />
+        </Stack>
+      </Stack>
+    </Box>
+  )
+}