@telus-uds/components-base 0.0.2-prerelease.6 → 1.0.0

package/__tests__/IconButton/IconButton.test.jsx

@@ -0,0 +1,52 @@
+import React from 'react'
+import { fireEvent, render } from '@testing-library/react-native'
+
+import { IconButton } from '../../src'
+import Theme from '../../__fixtures__/Theme'
+
+describe('IconButton', () => {
+  it('renders a link if href is passed', () => {
+    const { queryByRole } = render(<IconButton href="https://telus.com" icon={() => null} />, {
+      wrapper: Theme
+    })
+
+    expect(queryByRole('link')).toBeTruthy()
+
+    expect(queryByRole('button')).toBeFalsy()
+  })
+
+  it('renders a button if onPress is passed', () => {
+    const { queryByRole } = render(<IconButton onPress={() => {}} icon={() => null} />, {
+      wrapper: Theme
+    })
+
+    expect(queryByRole('button')).toBeTruthy()
+
+    expect(queryByRole('link')).toBeFalsy()
+  })
+
+  it('renders an accessible label', () => {
+    const { getByA11yLabel } = render(
+      <IconButton onPress={() => {}} icon={() => null} accessibilityLabel="test label" />,
+      {
+        wrapper: Theme
+      }
+    )
+
+    expect(getByA11yLabel('test label')).toBeTruthy()
+  })
+
+  it('calls onPress function when pressed', async () => {
+    const handlePress = jest.fn()
+    const { getByA11yLabel } = render(
+      <IconButton onPress={handlePress} icon={() => null} accessibilityLabel="test label" />,
+      {
+        wrapper: Theme
+      }
+    )
+    const iconButton = getByA11yLabel('test label')
+    expect(handlePress).toHaveBeenCalledTimes(0)
+    await fireEvent.press(iconButton)
+    expect(handlePress).toHaveBeenCalledTimes(1)
+  })
+})

package/__tests__/InputSupports/InputSupports.test.jsx

@@ -0,0 +1,50 @@
+import React from 'react'
+import { fireEvent, render } from '@testing-library/react-native'
+
+import InputSupports from '../../src/InputSupports'
+import Theme from '../../__fixtures__/Theme'
+import Viewport from '../../__fixtures__/Viewport'
+
+// eslint-disable-next-line react/prop-types
+const Wrapper = ({ children }) => (
+  <Viewport viewport="xs">
+    <Theme>{children}</Theme>
+  </Viewport>
+)
+
+describe('InputSupports', () => {
+  it('renders the label', () => {
+    const { queryByText } = render(<InputSupports label="Test label content" />, {
+      wrapper: Wrapper
+    })
+
+    expect(queryByText('Test label content')).toBeTruthy()
+  })
+
+  it('renders the hint', () => {
+    const { queryByText } = render(
+      <InputSupports label="Test label content" hint="Test hint content" />,
+      { wrapper: Wrapper }
+    )
+
+    expect(queryByText('Test hint content')).toBeTruthy()
+  })
+
+  it('renders the feedback', () => {
+    const { queryByText } = render(<InputSupports feedback="Test feedback content" />, {
+      wrapper: Wrapper
+    })
+
+    expect(queryByText('Test feedback content')).toBeTruthy()
+  })
+
+  it('renders the tooltip which content shows up when pressed', () => {
+    const { queryByText, getByRole } = render(
+      <InputSupports label="Test label content" tooltip="Test tooltip content" />,
+      { wrapper: Wrapper }
+    )
+
+    fireEvent(getByRole('button'), 'press')
+    expect(queryByText('Test tooltip content')).toBeTruthy()
+  })
+})

package/__tests__/Link/LinkBase.test.jsx

@@ -8,20 +8,6 @@ import LinkBase from '../../src/Link/LinkBase'
 beforeEach(() => jest.clearAllMocks())
 
 describe('LinkBase', () => {
-  it('throws if both href and onPress are provided', async () => {
-    jest.spyOn(console, 'error').mockImplementation()
-    expect(() =>
-      render(
-        <Theme>
-          <LinkBase href="example.com" onPress={jest.fn()}>
-            click me
-          </LinkBase>
-        </Theme>
-      )
-    ).toThrow()
-    expect(console.error).toHaveBeenCalledTimes(1)
-  })
-
   it('throws if neither href nor onPress are provided', async () => {
     jest.spyOn(console, 'error').mockImplementation()
     expect(() =>

package/__tests__/List/List.test.jsx

@@ -0,0 +1,60 @@
+import React from 'react'
+import { Text } from 'react-native'
+import { render } from '@testing-library/react-native'
+import { List } from '../../src'
+import Theme from '../../__fixtures__/Theme'
+import testTheme from '../../__fixtures__/testTheme'
+
+const setup = ({ showDivider = false, icon, children } = {}) =>
+  render(
+    <Theme>
+      <List showDivider={showDivider}>
+        <List.Item icon={icon}>{children || 'Item'}</List.Item>
+        <List.Item icon={icon}>{children || 'Item'}</List.Item>
+        <List.Item icon={icon}>{children || 'Item'}</List.Item>
+        <List.Item icon={icon}>{children || 'Item'}</List.Item>
+      </List>
+    </Theme>
+  )
+
+describe('List', () => {
+  it('should render bullets by default', () => {
+    const { queryAllByTestId } = setup()
+    const bullet = queryAllByTestId('unordered-item-bullet')
+    expect(bullet.length).toBe(4)
+  })
+
+  it('should render dividers for all items except for the last one', () => {
+    const { getAllByRole } = setup({ showDivider: true })
+    const {
+      interItemMarginWithDivider: marginBottom,
+      dividerColor: borderColor,
+      dividerSize: borderBottomWidth
+    } = testTheme.components.List.tokens
+
+    const listItems = getAllByRole('item')
+
+    listItems.forEach((item, index) => {
+      if (index + 1 !== listItems.length) {
+        expect(item).toHaveStyle({ marginBottom, borderColor, borderBottomWidth })
+      } else {
+        expect(item).toHaveStyle({})
+      }
+    })
+  })
+
+  it('should render the icon when defined', () => {
+    const { queryAllByTestId } = setup({ icon: () => <Text testID="icon" /> })
+
+    const icons = queryAllByTestId('icon')
+
+    expect(icons.length).toBe(4)
+  })
+  it('should allow children nested components', () => {
+    const { queryAllByTestId } = setup({ children: <Text testID="child" /> })
+
+    const children = queryAllByTestId('child')
+
+    expect(children.length).toBe(4)
+  })
+})

package/__tests__/Modal/Modal.test.jsx

@@ -0,0 +1,47 @@
+import React from 'react'
+import { Text } from 'react-native'
+import { fireEvent, render } from '@testing-library/react-native'
+
+import { Modal } from '../../src'
+import Theme from '../../__fixtures__/Theme'
+
+describe('Modal', () => {
+  it('is not rendered when closed', () => {
+    const { queryByText } = render(
+      <Modal>
+        <Text>Test content</Text>
+      </Modal>,
+      { wrapper: Theme }
+    )
+
+    expect(queryByText('Test content')).toBeFalsy()
+  })
+
+  it('is rendered when open', () => {
+    const { queryByText } = render(
+      <Modal isOpen>
+        <Text>Test content</Text>
+      </Modal>,
+      { wrapper: Theme }
+    )
+
+    expect(queryByText('Test content')).not.toBeFalsy()
+  })
+
+  it('onClose callback is triggered when closing', () => {
+    const onClose = jest.fn()
+
+    const { getByA11yRole } = render(
+      <Modal isOpen onClose={onClose}>
+        <Text>Test content</Text>
+      </Modal>,
+      { wrapper: Theme }
+    )
+
+    expect(onClose).not.toHaveBeenCalled()
+
+    fireEvent.press(getByA11yRole('button'))
+
+    expect(onClose).toHaveBeenCalledTimes(1)
+  })
+})

package/__tests__/Notification/Notification.test.jsx

@@ -0,0 +1,20 @@
+import React from 'react'
+import { fireEvent, render } from '@testing-library/react-native'
+
+import { Notification } from '../../src'
+import Theme from '../../__fixtures__/Theme'
+
+describe('Notification', () => {
+  it('is removed when dismiss button is pressed', () => {
+    const content = 'Notification content lands here'
+    const { getByRole, getByText } = render(<Notification dismissible>{content}</Notification>, {
+      wrapper: Theme
+    })
+
+    expect(() => getByText(content)).not.toThrow()
+
+    fireEvent.press(getByRole('button'))
+
+    expect(() => getByText(content)).toThrow()
+  })
+})

package/__tests__/Pagination/Pagination.test.jsx

@@ -114,7 +114,7 @@ describe('Pagination', () => {
 
       expect(button).toHaveProp('accessibilityRole', 'link')
       expect(button).toHaveProp('href', 'test-url')
-      expect(button).toHaveProp('target', '_blank')
+      expect(button).toHaveProp('hrefAttrs', { target: '_blank' })
     })
   })
 
@@ -154,7 +154,7 @@ describe('Pagination', () => {
 
       expect(button).toHaveProp('accessibilityRole', 'link')
       expect(button).toHaveProp('href', 'test-url')
-      expect(button).toHaveProp('target', '_blank')
+      expect(button).toHaveProp('hrefAttrs', { target: '_blank' })
     })
   })
 })

package/__tests__/Progress/Progress.test.jsx

@@ -0,0 +1,79 @@
+import React from 'react'
+import { Text } from 'react-native'
+import { render, within } from '@testing-library/react-native'
+
+import { Progress } from '../../src'
+import Theme from '../../__fixtures__/Theme'
+
+const barTokens = {
+  backgroundColor: 'green'
+}
+const percentage = 75
+const progressTokens = {
+  backgroundColor: 'white',
+  borderColor: 'black'
+}
+const a11yLabel = 'Progress bar'
+const progressA11yLabel = 'This is a progress indicator'
+const setup = (
+  { children, ...props } = {
+    children: (
+      <Progress.Bar percentage={percentage} tokens={barTokens} accessibilityLabel={a11yLabel} />
+    )
+  }
+) =>
+  render(
+    <Progress tokens={progressTokens} accessibilityLabel={progressA11yLabel} {...props}>
+      {children}
+    </Progress>,
+    { wrapper: Theme }
+  )
+
+describe('Progress', () => {
+  it('renders with correct percentage and applies tokens accordingly', () => {
+    const { getByA11yLabel } = setup()
+    expect(getByA11yLabel(progressA11yLabel)).toHaveStyle(progressTokens)
+    expect(getByA11yLabel(a11yLabel)).toHaveStyle({
+      width: `${percentage}%`,
+      ...barTokens
+    })
+  })
+
+  it('renders arbitrary content inside the progress bar', () => {
+    const contentText = 'This can be an arbitrary content'
+    const { getByA11yLabel } = setup({
+      children: (
+        <Progress.Bar percentage={percentage} tokens={barTokens} accessibilityLabel={a11yLabel}>
+          <Text>{contentText}</Text>
+        </Progress.Bar>
+      )
+    })
+    expect(within(getByA11yLabel(a11yLabel)).getByText(contentText)).toBeTruthy()
+  })
+
+  it('renders proper accessibility attributes on the progress bar', () => {
+    const { getByA11yRole, getByA11yValue } = setup()
+    expect(getByA11yRole('progressbar')).toBeTruthy()
+    expect(
+      getByA11yValue({ min: 0, max: 100, now: percentage, text: `${percentage}%` })
+    ).toBeTruthy()
+  })
+
+  it('renders stacked progress bars', () => {
+    const inactiveA11yLabel = 'This bar is inactive'
+    const { getByA11yLabel } = setup({
+      children: (
+        <>
+          <Progress.Bar
+            percentage={percentage + 10}
+            variant={{ inactive: true }}
+            accessibilityLabel={inactiveA11yLabel}
+          />
+          <Progress.Bar percentage={percentage} accessibilityLabel={a11yLabel} />
+        </>
+      )
+    })
+    expect(within(getByA11yLabel(progressA11yLabel)).getByA11yLabel(inactiveA11yLabel)).toBeTruthy()
+    expect(within(getByA11yLabel(progressA11yLabel)).getByA11yLabel(a11yLabel)).toBeTruthy()
+  })
+})

package/__tests__/Radio/Radio.test.jsx

@@ -0,0 +1,87 @@
+import React from 'react'
+import { fireEvent, render } from '@testing-library/react-native'
+
+import { Radio } from '../../src'
+import Theme from '../../__fixtures__/Theme'
+
+const checkedId = 'Radio-Checked'
+const inputId = 'Radio-Input'
+const setup = (props) =>
+  render(
+    <Theme>
+      <Radio {...props} />
+    </Theme>
+  )
+
+describe('Radio', () => {
+  it('renders with defaults', () => {
+    const { getByRole } = setup()
+
+    expect(getByRole('radio')).toBeTruthy()
+  })
+
+  it('renders the label', () => {
+    const label = 'Test label message'
+    const { queryByText } = setup({ label })
+
+    expect(queryByText(label)).toBeTruthy()
+  })
+
+  it('renders error styling on validation failure', () => {
+    const errorBorderColor = '#e12339' // from __fixtures__/testTheme.js
+    const { getByTestId } = setup({ error: true })
+
+    const radioInput = getByTestId(inputId)
+    expect(radioInput).toHaveStyle({ borderColor: errorBorderColor })
+  })
+
+  it('triggers the callback', () => {
+    const onChange = jest.fn()
+
+    const { getByRole } = setup({ onChange })
+
+    const radio = getByRole('radio')
+    expect(onChange).not.toHaveBeenCalled()
+    fireEvent(radio, 'press')
+    expect(onChange).toHaveBeenCalledTimes(1)
+  })
+
+  it('cannot be changed if inactive', () => {
+    const { getByRole, queryByTestId } = setup({ inactive: true })
+
+    const radio = getByRole('radio')
+    expect(queryByTestId(checkedId)).toBeFalsy()
+    fireEvent(radio, 'press')
+    expect(queryByTestId(checkedId)).toBeFalsy()
+  })
+
+  describe('when uncontrolled', () => {
+    it('uses `defaultChecked` as the initial value', () => {
+      const { queryByTestId } = setup({ defaultChecked: true })
+
+      expect(queryByTestId(checkedId)).toBeTruthy()
+    })
+
+    it('changes value', () => {
+      const { getByRole, queryByTestId } = setup({ defaultChecked: false })
+
+      const radio = getByRole('radio')
+      expect(queryByTestId(checkedId)).toBeFalsy()
+      fireEvent(radio, 'press')
+      expect(queryByTestId(checkedId)).toBeTruthy()
+    })
+  })
+
+  describe('when controlled', () => {
+    it('calls `onChange` with the new value', () => {
+      const onChange = jest.fn()
+      const { getByRole, queryByTestId } = setup({ onChange, checked: false })
+
+      const radio = getByRole('radio')
+      expect(queryByTestId(checkedId)).toBeFalsy()
+      fireEvent(radio, 'press', { nativeEvent: 'example' })
+      expect(onChange).toHaveBeenCalledTimes(1)
+      expect(onChange).toHaveBeenCalledWith(true, { nativeEvent: 'example' })
+    })
+  })
+})

package/__tests__/Radio/RadioGroup.test.jsx

@@ -0,0 +1,220 @@
+import React from 'react'
+import { render, fireEvent } from '@testing-library/react-native'
+import { toHaveTextContent } from '@testing-library/jest-native'
+
+import Theme from '../../__fixtures__/Theme'
+import RadioGroup from '../../src/Radio/RadioGroup'
+
+const items = [
+  { label: 'One', id: 'one' },
+  { label: 'Two', id: 'two' },
+  { label: 'Three', id: 'three' },
+  { label: 'Four', id: 'four' }
+]
+const checked = { checked: true }
+
+// expect().toHaveTextContent doesn't work on arrays, expect().toContain etc doesn't match elements
+const containsText = (queryResult, text) =>
+  queryResult.some((testInstance) => toHaveTextContent(testInstance, text).pass)
+
+describe('RadioGroup', () => {
+  // eslint-disable-next-line no-console
+  const consoleError = console.error
+  beforeEach(() => {
+    // eslint-disable-next-line no-console
+    console.error = () => {}
+  })
+  afterEach(() => {
+    // eslint-disable-next-line no-console
+    console.error = consoleError
+  })
+
+  it('Throws if has `checkedId` without `onChange`', () => {
+    expect(() =>
+      render(
+        <Theme>
+          <RadioGroup items={items} checkedId="one" />
+        </Theme>
+      )
+    ).toThrow(/value.+without.+onChange/)
+  })
+  it("Doesn't throw if has `checkedId` without `onChange` and is read only", () => {
+    expect(() =>
+      render(
+        <Theme>
+          <RadioGroup items={items} checkedId="one" readOnly />
+        </Theme>
+      )
+    ).not.toThrow()
+  })
+  it('Throws if has both `checkedId` and `initialCheckedId`', () => {
+    expect(() =>
+      render(
+        <Theme>
+          <RadioGroup items={items} initialCheckedId="one" checkedId="one" onChange={() => {}} />
+        </Theme>
+      )
+    ).toThrow(/both(?=.*initialValue)(?=.*value){2}/)
+  })
+})
+
+describe('RadioGroup (uncontrolled)', () => {
+  it('Selects one and only one item', async () => {
+    const { getByText, queryAllByA11yState } = render(
+      <Theme>
+        <RadioGroup items={items} />
+      </Theme>
+    )
+
+    expect(queryAllByA11yState(checked)).toHaveLength(0)
+
+    const one = getByText('One')
+    await fireEvent.press(one)
+    expect(queryAllByA11yState(checked)).toHaveLength(1)
+    expect(containsText(queryAllByA11yState(checked), 'One')).toBeTruthy()
+
+    const two = getByText('Two')
+    await fireEvent.press(two)
+    expect(queryAllByA11yState(checked)).toHaveLength(1)
+    expect(containsText(queryAllByA11yState(checked), 'Two')).toBeTruthy()
+    expect(containsText(queryAllByA11yState(checked), 'One')).not.toBeTruthy()
+  })
+
+  it('Does not deselect if the selected item is pressed', async () => {
+    const { getByText, queryAllByA11yState } = render(
+      <Theme>
+        <RadioGroup items={items} />
+      </Theme>
+    )
+
+    expect(queryAllByA11yState(checked)).toHaveLength(0)
+
+    const three = getByText('Three')
+    await fireEvent.press(three)
+    expect(queryAllByA11yState(checked)).toHaveLength(1)
+    expect(containsText(queryAllByA11yState(checked), 'Three')).toBeTruthy()
+
+    await fireEvent.press(three)
+    expect(queryAllByA11yState(checked)).toHaveLength(1)
+    expect(containsText(queryAllByA11yState(checked), 'Three')).toBeTruthy()
+  })
+
+  it('Is accessible as a radio button', async () => {
+    const { queryAllByA11yRole, queryAllByA11yState } = render(
+      <Theme>
+        <RadioGroup items={items} />
+      </Theme>
+    )
+
+    expect(queryAllByA11yRole('checkbox')).toHaveLength(0)
+    expect(queryAllByA11yRole('radiogroup')).toHaveLength(1)
+    const radios = queryAllByA11yRole('radio')
+    expect(radios).toHaveLength(4)
+
+    expect(queryAllByA11yState(checked)).toHaveLength(0)
+    await fireEvent.press(radios[0])
+    expect(queryAllByA11yState(checked)).toHaveLength(1)
+  })
+
+  it('Auto-selects initialCheckedId', async () => {
+    const { getByText, queryAllByA11yState } = render(
+      <Theme>
+        <RadioGroup items={items} initialCheckedId="two" />
+      </Theme>
+    )
+    expect(queryAllByA11yState(checked)).toHaveLength(1)
+    expect(containsText(queryAllByA11yState(checked), 'One')).not.toBeTruthy()
+    expect(containsText(queryAllByA11yState(checked), 'Two')).toBeTruthy()
+
+    const three = getByText('Three')
+    await fireEvent.press(three)
+
+    expect(queryAllByA11yState(checked)).toHaveLength(1)
+    expect(containsText(queryAllByA11yState(checked), 'Three')).toBeTruthy()
+    expect(containsText(queryAllByA11yState(checked), 'Two')).not.toBeTruthy()
+    expect(containsText(queryAllByA11yState(checked), 'One')).not.toBeTruthy()
+  })
+})
+
+describe('RadioGroup (controlled)', () => {
+  it('Calls onChange handler on press in controlled mode, providing pressed id', async () => {
+    const handleChange = jest.fn((arg) => arg)
+    const { getByText } = render(
+      <Theme>
+        <RadioGroup items={items} checkedId={null} onChange={handleChange} />
+      </Theme>
+    )
+
+    expect(handleChange).toHaveBeenCalledTimes(0)
+
+    const one = getByText('One')
+    await fireEvent(one, 'press', { nativeEvent: 'example' })
+    expect(handleChange).toHaveBeenCalledTimes(1)
+    expect(handleChange).toHaveBeenLastCalledWith('one', { nativeEvent: 'example' })
+
+    const two = getByText('Two')
+    await fireEvent(two, 'press', { nativeEvent: 'example2' })
+    expect(handleChange).toHaveBeenCalledTimes(2)
+    expect(handleChange).toHaveBeenLastCalledWith('two', { nativeEvent: 'example2' })
+  })
+
+  it("Doesn't change its own selection if `checkedId` is passed", async () => {
+    const { getByText, queryAllByA11yState } = render(
+      <Theme>
+        <RadioGroup items={items} checkedId="one" onChange={() => {}} />
+      </Theme>
+    )
+
+    expect(queryAllByA11yState(checked)).toHaveLength(1)
+    expect(containsText(queryAllByA11yState(checked), 'One')).toBeTruthy()
+
+    const two = getByText('Two')
+    await fireEvent.press(two)
+    expect(queryAllByA11yState(checked)).toHaveLength(1)
+    expect(containsText(queryAllByA11yState(checked), 'Two')).not.toBeTruthy()
+    expect(containsText(queryAllByA11yState(checked), 'One')).toBeTruthy()
+  })
+})
+
+describe('RadioGroup (read-only)', () => {
+  it("Doesn't call onChange handler when read-only", async () => {
+    const handleChange = jest.fn((arg) => arg)
+    const { getByText } = render(
+      <Theme>
+        <RadioGroup items={items} checkedId="two" onChange={handleChange} readOnly />
+      </Theme>
+    )
+
+    expect(handleChange).toHaveBeenCalledTimes(0)
+
+    const one = getByText('One')
+    await fireEvent.press(one)
+    expect(handleChange).toHaveBeenCalledTimes(0)
+
+    const two = getByText('Two')
+    await fireEvent.press(two)
+    expect(handleChange).toHaveBeenCalledTimes(0)
+  })
+
+  it("Doesn't change its selection on press", async () => {
+    const { getByText, queryAllByA11yState } = render(
+      <Theme>
+        <RadioGroup items={items} checkedId="one" readOnly />
+      </Theme>
+    )
+
+    expect(queryAllByA11yState(checked)).toHaveLength(1)
+    expect(containsText(queryAllByA11yState(checked), 'One')).toBeTruthy()
+
+    const one = getByText('One')
+    await fireEvent.press(one)
+    expect(queryAllByA11yState(checked)).toHaveLength(1)
+    expect(containsText(queryAllByA11yState(checked), 'One')).toBeTruthy()
+
+    const two = getByText('Two')
+    await fireEvent.press(two)
+    expect(queryAllByA11yState(checked)).toHaveLength(1)
+    expect(containsText(queryAllByA11yState(checked), 'Two')).not.toBeTruthy()
+    expect(containsText(queryAllByA11yState(checked), 'One')).toBeTruthy()
+  })
+})