@bettercms-ai/kit 0.1.0

package/src/core/primitives/textInput/__workshop__/plain.tsx

@@ -0,0 +1,98 @@
+import {icons, IconSymbol} from '@bettercms-ai/icons/map'
+import {Container, Flex, Stack, Text, TextInput} from '@bettercms-ai/kit'
+import {useBoolean, useSelect, useText} from '@bettercms-ai/kit-workshop'
+import {PerfTestProps, usePerfTest} from '@bettercms-ai/kit-workshop/plugin-perf'
+import {fireEvent} from '@testing-library/dom'
+import {useCallback, useState} from 'react'
+
+import {
+  WORKSHOP_FONT_WEIGHT_OPTIONS,
+  WORKSHOP_ICON_SYMBOL_OPTIONS,
+  WORKSHOP_RADIUS_OPTIONS,
+  WORKSHOP_SPACE_OPTIONS,
+  WORKSHOP_TEXT_FONT_SIZE_OPTIONS,
+} from '../../../__workshop__/constants'
+
+const typingPerfTest: PerfTestProps<HTMLInputElement> = {
+  name: 'typing',
+  title: 'Typing',
+  description: 'This test types one character at a time',
+  run({target}) {
+    const text = 'Hello, world & Hello, world & Hello, world'
+    const len = text.length
+
+    for (let i = 0; i < len; i += 1) {
+      const value = text.slice(0, i + 1)
+
+      fireEvent.change(target, {target: {value}})
+    }
+  },
+}
+
+export default function PlainStory() {
+  const {ref, Wrapper} = usePerfTest(typingPerfTest)
+
+  return (
+    <Flex align="center" height="fill" justify="center" padding={[4, 5, 6]} sizing="border">
+      <Container width={0}>
+        <Stack space={3}>
+          <Text as="label" htmlFor="text-input-example" size={1} weight="medium">
+            TextInput
+          </Text>
+          <Wrapper>
+            <TextInputTest inputRef={ref} />
+          </Wrapper>
+        </Stack>
+      </Container>
+    </Flex>
+  )
+}
+
+function TextInputTest(props: {inputRef: React.Ref<HTMLInputElement>}) {
+  const {inputRef: ref} = props
+  const border = useBoolean('Border', true, 'Props')
+  const customValidity = useText('Custom validity', '', 'Props') || undefined
+  const disabled = useBoolean('Disabled', false, 'Props')
+  const fontSize = useSelect('Font size', WORKSHOP_TEXT_FONT_SIZE_OPTIONS, 2, 'Props')
+  const icon = useSelect('Icon', WORKSHOP_ICON_SYMBOL_OPTIONS, 'search', 'Props') as IconSymbol
+  const iconRight = useSelect(
+    'Icon (right)',
+    WORKSHOP_ICON_SYMBOL_OPTIONS,
+    'cube',
+    'Props',
+  ) as IconSymbol
+  const padding = useSelect('Padding', WORKSHOP_SPACE_OPTIONS, 3, 'Props')
+  const placeholder = useText('Placeholder', '', 'Props') || undefined
+  const radius = useSelect('Radius', WORKSHOP_RADIUS_OPTIONS, 2, 'Props')
+  const readOnly = useBoolean('Read only', false, 'Props')
+  const space = useSelect('Space', WORKSHOP_SPACE_OPTIONS, 3, 'Props')
+  const weight = useSelect('Weight', WORKSHOP_FONT_WEIGHT_OPTIONS, '', 'Props') || undefined
+
+  const [value, setValue] = useState('')
+
+  const handleChange = useCallback(
+    (event: React.ChangeEvent<HTMLInputElement>) => setValue(event.currentTarget.value),
+    [],
+  )
+
+  return (
+    <TextInput
+      border={border}
+      customValidity={customValidity}
+      disabled={disabled}
+      fontSize={fontSize}
+      icon={icon && icons[icon]}
+      iconRight={iconRight && icons[iconRight]}
+      id="text-input-example"
+      onChange={handleChange}
+      padding={padding}
+      placeholder={placeholder}
+      radius={radius}
+      readOnly={readOnly}
+      ref={ref}
+      space={space}
+      value={value}
+      weight={weight}
+    />
+  )
+}

package/src/core/primitives/textInput/__workshop__/readOnly.tsx

@@ -0,0 +1,9 @@
+import {Flex, TextInput} from '@bettercms-ai/kit'
+
+export default function ReadOnlyStory() {
+  return (
+    <Flex padding={4}>
+      <TextInput id="text-input-example" readOnly />
+    </Flex>
+  )
+}

package/src/core/primitives/textInput/__workshop__/states.tsx

@@ -0,0 +1,53 @@
+import {Container, Flex, Stack, Text, TextInput} from '@bettercms-ai/kit'
+import {useAction, useBoolean} from '@bettercms-ai/kit-workshop'
+
+export default function StatesStory() {
+  const invalid = useBoolean('Invalid', false, 'Props')
+  const onChange = useAction('onChange')
+
+  return (
+    <Flex align="center" height="fill" justify="center" padding={[4, 5, 6]} sizing="border">
+      <Container width={1}>
+        <Stack space={5}>
+          <Stack space={3}>
+            <Text size={1} weight="medium">
+              <label htmlFor="enabled-example">Enabled (default)</label>
+            </Text>
+            <TextInput
+              customValidity={invalid ? 'invalid' : undefined}
+              id="enabled-example"
+              onChange={onChange}
+              value="This is some text"
+            />
+          </Stack>
+
+          <Stack space={3}>
+            <Text size={1} weight="medium">
+              <label htmlFor="disabled-example">Disabled</label>
+            </Text>
+            <TextInput
+              customValidity={invalid ? 'invalid' : undefined}
+              disabled
+              id="disabled-example"
+              onChange={onChange}
+              value="This is some text"
+            />
+          </Stack>
+
+          <Stack space={3}>
+            <Text size={1} weight="medium">
+              <label htmlFor="read-only-example">Read-only</label>
+            </Text>
+            <TextInput
+              customValidity={invalid ? 'invalid' : undefined}
+              id="read-only-example"
+              readOnly
+              onChange={onChange}
+              value="This is some text"
+            />
+          </Stack>
+        </Stack>
+      </Container>
+    </Flex>
+  )
+}

package/src/core/primitives/textInput/__workshop__/tones.tsx

@@ -0,0 +1,277 @@
+import {Box, Card, Container, Flex, Stack, Text, TextInput} from '@bettercms-ai/kit'
+import {useBoolean} from '@bettercms-ai/kit-workshop'
+
+export default function TonesStory() {
+  const transparentTone = useBoolean('Transparent', true)
+  const neutralTone = useBoolean('Neutral', true)
+  const primaryTone = useBoolean('Primary', true)
+  const suggestTone = useBoolean('Suggest', true)
+  const positiveTone = useBoolean('Positive', true)
+  const cautionTone = useBoolean('Caution', true)
+  const criticalTone = useBoolean('Critical', true)
+
+  return (
+    <Card height="fill" tone="transparent">
+      <Flex align="center" height="fill" justify="center">
+        <Container width={1}>
+          <Flex>
+            <Card flex={1} scheme="light">
+              <Stack padding={[3, 4, 5]} space={4}>
+                <Card padding={3}>
+                  <TextInput
+                    placeholder="default"
+                    prefix={
+                      <Box padding={3}>
+                        <Text>prefix</Text>
+                      </Box>
+                    }
+                    suffix={
+                      <Box padding={3}>
+                        <Text>suffix</Text>
+                      </Box>
+                    }
+                  />
+                </Card>
+
+                {transparentTone && (
+                  <Card padding={3} tone="transparent">
+                    <TextInput
+                      placeholder="transparent"
+                      prefix={
+                        <Box padding={3}>
+                          <Text>prefix</Text>
+                        </Box>
+                      }
+                      suffix={
+                        <Box padding={3}>
+                          <Text>suffix</Text>
+                        </Box>
+                      }
+                    />
+                  </Card>
+                )}
+
+                {neutralTone && (
+                  <Card padding={3} tone="neutral">
+                    <TextInput
+                      placeholder="neutral"
+                      prefix={
+                        <Box padding={3}>
+                          <Text>prefix</Text>
+                        </Box>
+                      }
+                      suffix={
+                        <Box padding={3}>
+                          <Text>suffix</Text>
+                        </Box>
+                      }
+                    />
+                  </Card>
+                )}
+
+                {primaryTone && (
+                  <Card padding={3} tone="primary">
+                    <TextInput
+                      placeholder="primary"
+                      prefix={
+                        <Box padding={3}>
+                          <Text>prefix</Text>
+                        </Box>
+                      }
+                      suffix={
+                        <Box padding={3}>
+                          <Text>suffix</Text>
+                        </Box>
+                      }
+                    />
+                  </Card>
+                )}
+
+                {suggestTone && (
+                  <Card padding={3} tone="suggest">
+                    <TextInput
+                      placeholder="suggest"
+                      prefix={
+                        <Box padding={3}>
+                          <Text>prefix</Text>
+                        </Box>
+                      }
+                      suffix={
+                        <Box padding={3}>
+                          <Text>suffix</Text>
+                        </Box>
+                      }
+                    />
+                  </Card>
+                )}
+
+                {positiveTone && (
+                  <Card padding={3} tone="positive">
+                    <TextInput
+                      placeholder="positive"
+                      prefix={
+                        <Box padding={3}>
+                          <Text>prefix</Text>
+                        </Box>
+                      }
+                      suffix={
+                        <Box padding={3}>
+                          <Text>suffix</Text>
+                        </Box>
+                      }
+                    />
+                  </Card>
+                )}
+
+                {cautionTone && (
+                  <Card padding={3} tone="caution">
+                    <TextInput
+                      placeholder="caution"
+                      prefix={
+                        <Box padding={3}>
+                          <Text>prefix</Text>
+                        </Box>
+                      }
+                      suffix={
+                        <Box padding={3}>
+                          <Text>suffix</Text>
+                        </Box>
+                      }
+                    />
+                  </Card>
+                )}
+
+                {criticalTone && (
+                  <Card padding={3} tone="critical">
+                    <TextInput
+                      placeholder="critical"
+                      prefix={
+                        <Box padding={3}>
+                          <Text>prefix</Text>
+                        </Box>
+                      }
+                      suffix={
+                        <Box padding={3}>
+                          <Text>suffix</Text>
+                        </Box>
+                      }
+                    />
+                  </Card>
+                )}
+              </Stack>
+            </Card>
+            <Card flex={1} scheme="dark">
+              <Stack padding={[3, 4, 5]} space={4}>
+                <Card padding={3}>
+                  <TextInput
+                    placeholder="default"
+                    prefix={
+                      <Box padding={3}>
+                        <Text>prefix</Text>
+                      </Box>
+                    }
+                    suffix={
+                      <Box padding={3}>
+                        <Text>suffix</Text>
+                      </Box>
+                    }
+                  />
+                </Card>
+
+                {transparentTone && (
+                  <Card padding={3} tone="transparent">
+                    <TextInput
+                      placeholder="transparent"
+                      prefix={
+                        <Box padding={3}>
+                          <Text>prefix</Text>
+                        </Box>
+                      }
+                      suffix={
+                        <Box padding={3}>
+                          <Text>suffix</Text>
+                        </Box>
+                      }
+                    />
+                  </Card>
+                )}
+
+                {primaryTone && (
+                  <Card padding={3} tone="primary">
+                    <TextInput
+                      placeholder="primary"
+                      prefix={
+                        <Box padding={3}>
+                          <Text>prefix</Text>
+                        </Box>
+                      }
+                      suffix={
+                        <Box padding={3}>
+                          <Text>suffix</Text>
+                        </Box>
+                      }
+                    />
+                  </Card>
+                )}
+
+                {positiveTone && (
+                  <Card padding={3} tone="positive">
+                    <TextInput
+                      placeholder="positive"
+                      prefix={
+                        <Box padding={3}>
+                          <Text>prefix</Text>
+                        </Box>
+                      }
+                      suffix={
+                        <Box padding={3}>
+                          <Text>suffix</Text>
+                        </Box>
+                      }
+                    />
+                  </Card>
+                )}
+
+                {cautionTone && (
+                  <Card padding={3} tone="caution">
+                    <TextInput
+                      placeholder="caution"
+                      prefix={
+                        <Box padding={3}>
+                          <Text>prefix</Text>
+                        </Box>
+                      }
+                      suffix={
+                        <Box padding={3}>
+                          <Text>suffix</Text>
+                        </Box>
+                      }
+                    />
+                  </Card>
+                )}
+
+                {criticalTone && (
+                  <Card padding={3} tone="critical">
+                    <TextInput
+                      placeholder="critical"
+                      prefix={
+                        <Box padding={3}>
+                          <Text>prefix</Text>
+                        </Box>
+                      }
+                      suffix={
+                        <Box padding={3}>
+                          <Text>suffix</Text>
+                        </Box>
+                      }
+                    />
+                  </Card>
+                )}
+              </Stack>
+            </Card>
+          </Flex>
+        </Container>
+      </Flex>
+    </Card>
+  )
+}

package/src/core/primitives/textInput/__workshop__/typed.tsx

@@ -0,0 +1,23 @@
+import {Box, Container, TextInput} from '@bettercms-ai/kit'
+import {useSelect} from '@bettercms-ai/kit-workshop'
+import {useCallback, useState} from 'react'
+
+import {WORKSHOP_TEXT_INPUT_TYPE_OPTIONS} from '../../../__workshop__/constants'
+
+export default function TypedStory() {
+  const type = useSelect('Type', WORKSHOP_TEXT_INPUT_TYPE_OPTIONS, 'text', 'Props')
+
+  const [value, setValue] = useState('')
+
+  const handleChange = useCallback((event: React.ChangeEvent<HTMLInputElement>) => {
+    setValue(event.currentTarget.value)
+  }, [])
+
+  return (
+    <Box padding={4}>
+      <Container width={1}>
+        <TextInput onChange={handleChange} type={type} value={value} />
+      </Container>
+    </Box>
+  )
+}

package/src/core/primitives/textInput/index.ts

@@ -0,0 +1 @@
+export * from './textInput'

package/src/core/primitives/textInput/textInput.test.tsx

@@ -0,0 +1,48 @@
+/** @jest-environment jsdom */
+
+import {render} from '../../../../test'
+import {responsiveInputPaddingStyle} from '../../styles/internal'
+import {TextInput} from './textInput'
+
+jest.mock('../../styles/internal', () => {
+  const actual = jest.requireActual('../../styles/internal')
+
+  return {
+    ...actual,
+    responsiveInputPaddingStyle: jest.fn(actual.responsiveInputPaddingStyle),
+  }
+})
+
+describe('primitives/textInput', () => {
+  const mockedResponsiveInputPaddingStyle = jest.mocked(responsiveInputPaddingStyle)
+
+  beforeEach(() => {
+    mockedResponsiveInputPaddingStyle.mockClear()
+  })
+
+  it('should support `space` and `gap` with the same behavior', () => {
+    render(<TextInput icon={() => null} space={2} />)
+
+    expect(mockedResponsiveInputPaddingStyle).toHaveBeenCalledWith(
+      expect.objectContaining({$space: [2]}),
+    )
+
+    mockedResponsiveInputPaddingStyle.mockClear()
+    render(<TextInput gap={2} icon={() => null} />)
+
+    expect(mockedResponsiveInputPaddingStyle).toHaveBeenCalledWith(
+      expect.objectContaining({$space: [2]}),
+    )
+  })
+
+  it('should prefer `gap` over `space` when both are provided', () => {
+    render(<TextInput gap={3} icon={() => null} space={1} />)
+
+    expect(mockedResponsiveInputPaddingStyle).toHaveBeenCalledWith(
+      expect.objectContaining({$space: [3]}),
+    )
+    expect(mockedResponsiveInputPaddingStyle).not.toHaveBeenCalledWith(
+      expect.objectContaining({$space: [1]}),
+    )
+  })
+})