@utilitywarehouse/hearth-react-native 0.12.0 → 0.14.0

package/src/components/Switch/Switch.figma.tsx

@@ -1,29 +1,37 @@
-import { Switch } from './';
 import figma from '@figma/code-connect';
+import Switch from './Switch';
 
 /**
  * -- This file was auto-generated by Code Connect --
- * `props` includes a mapping from Figma properties and variants to
- * suggested values. You should update this to match the props of your
- * code component, and update the `example` function to return the
- * code example you'd like to see in Figma
+ * `props` includes a mapping from your code props to Figma properties.
+ * You should check this is correct, and update the `example` function
+ * to return the code example you'd like to see in Figma
  */
 
-figma.connect(
-  Switch,
-  'https://www.figma.com/design/3RY3OvLA88yZksRjOfjQJm/UW-App-UI?node-id=9551-7352&t=fDsV1m42i8hVbZo3-4',
-  {
-    props: {
-      value: figma.boolean('checked'),
-      state: figma.enum('state', {
-        default: 'default',
-      }),
-      size: figma.enum('size', {
-        'medium - 32': 'medium',
-        'small - 24': 'small',
-      }),
-      disabled: figma.boolean('disabled'),
-    },
-    example: props => <Switch {...props} />,
-  }
-);
+figma.connect(Switch, 'https://www.figma.com/design/6NKZXZhFSExXrcbBgc6zTR?node-id=3044%3A243', {
+  props: {
+    // These props were automatically mapped based on your linked code:
+    disabled: figma.enum('State', {
+      Disabled: true,
+    }),
+    'aria-disabled': figma.enum('State', {
+      Disabled: true,
+    }),
+    focusable: figma.enum('State', {
+      Focus: true,
+    }),
+    checked: figma.boolean('Checked?'),
+    size: figma.enum('Size', {
+      'MD-32': 'medium',
+      'SM-24': 'small',
+    }),
+  },
+  example: props => (
+    <Switch
+      value={props.checked}
+      disabled={props.disabled}
+      focusable={props.focusable}
+      size={props.size}
+    />
+  ),
+});

package/src/components/Tabs/Tab.tsx

@@ -76,11 +76,11 @@ const styles = StyleSheet.create(theme => ({
       _hover: {
         backgroundColor: theme.color.interactive.neutral.surface.subtle.hover,
       },
-      '_focus-visible': {
-        ...theme.helpers.focusVisible,
-        outlineOffset: -2,
-        borderRadius: theme.borderRadius.sm,
-      },
+      // '_focus-visible': {
+      //   ...theme.helpers.focusVisible,
+      //   outlineOffset: -2,
+      //   borderRadius: theme.borderRadius.sm,
+      // },
       _active: {
         backgroundColor: theme.color.interactive.neutral.surface.subtle.active,
       },

package/src/components/Tabs/Tabs.figma.tsx

@@ -0,0 +1,29 @@
+import React from "react"
+import Tabs from "./Tabs"
+import figma from "@figma/code-connect"
+
+/**
+ * -- This file was auto-generated by Code Connect --
+ * `props` includes a mapping from your code props to Figma properties.
+ * You should check this is correct, and update the `example` function
+ * to return the code example you'd like to see in Figma
+ */
+
+figma.connect(
+  Tabs,
+  "https://www.figma.com/design/6NKZXZhFSExXrcbBgc6zTR?node-id=6464%3A8744",
+  {
+    props: {
+      // These props were automatically mapped based on your linked code:
+      size: figma.enum("Size", {
+        "MD-56": "md",
+        "LG-64": "lg",
+      }),
+      // No matching props could be found for these Figma properties:
+      // "arrowLeft": figma.boolean('Arrow left?'),
+      // "arrowRight": figma.boolean('Arrow right?'),
+      // "condensed": figma.boolean('Condensed?')
+    },
+    example: (props) => <Tabs size={props.size} />,
+  },
+)

package/src/components/ThemedImage/ThemedImage.stories.tsx

@@ -1,4 +1,4 @@
-import type { Meta, StoryObj } from '@storybook/react';
+import type { Meta, StoryObj } from '@storybook/react-native';
 import MascotEnergyDark from '@utilitywarehouse/hearth-svg-assets/lib/mascot-energy-dark.svg';
 import MascotEnergyLight from '@utilitywarehouse/hearth-svg-assets/lib/mascot-energy-light.svg';
 import SceneBroadbandDark from '@utilitywarehouse/hearth-svg-assets/lib/scene-broadband-dark.svg';

package/src/components/Toast/ToastItem.figma.tsx

@@ -0,0 +1,22 @@
+import figma from '@figma/code-connect';
+import ToastItem from './ToastItem';
+
+/**
+ * -- This file was auto-generated by Code Connect --
+ * None of your props could be automatically mapped to Figma properties.
+ * You should update the `props` object to include a mapping from your
+ * code props to Figma properties, and update the `example` function to
+ * return the code example you'd like to see in Figma
+ */
+
+figma.connect(ToastItem, 'https://www.figma.com/design/6NKZXZhFSExXrcbBgc6zTR?node-id=7072%3A913', {
+  props: {
+    // No matching props could be found for these Figma properties:
+    // "link": figma.boolean('Link?'),
+    // "text": figma.string('Text'),
+    // "icon": figma.boolean('Icon?'),
+    // "icon24": figma.instance('Icon-24'),
+    // "dismiss": figma.boolean('Dismiss?')
+  },
+  example: props => <ToastItem toast={null} onClose={null} />,
+});

package/src/components/ToggleButton/ToggleButtonRoot.tsx

@@ -16,7 +16,7 @@ const ButtonRoot = ({
 
   styles.useVariants({
     toggled,
-    active: active || pressed,
+    active,
   });
 
   const handlePress = (e: GestureResponderEvent) => {
@@ -56,7 +56,7 @@ const styles = StyleSheet.create(theme => ({
     borderColor: theme.color.interactive.neutral.border.subtle,
     height: theme.components.toggleButton.height,
     _web: {
-      '_focus-visible': theme.helpers.focusVisible,
+      // '_focus-visible': theme.helpers.focusVisible,
       _hover: {
         backgroundColor: theme.color.interactive.neutral.surface.subtle.hover,
       },

package/src/components/ToggleButtonCard/ToggleButtonCardRoot.tsx

@@ -77,9 +77,9 @@ const styles = StyleSheet.create(theme => ({
       },
     },
     _web: {
-      '_focus-visible': {
-        ...theme.helpers.focusVisible,
-      },
+      // '_focus-visible': {
+      //   ...theme.helpers.focusVisible,
+      // },
     },
   },
   buttonContainer: {

package/src/components/UnstyledIconButton/UnstyledIconButton.figma.tsx

@@ -0,0 +1,49 @@
+import figma from '@figma/code-connect';
+import UnstyledIconButton from './UnstyledIconButton';
+
+/**
+ * -- This file was auto-generated by Code Connect --
+ * `props` includes a mapping from your code props to Figma properties.
+ * You should check this is correct, and update the `example` function
+ * to return the code example you'd like to see in Figma
+ */
+
+figma.connect(
+  UnstyledIconButton,
+  'https://www.figma.com/design/6NKZXZhFSExXrcbBgc6zTR?node-id=2926%3A2430',
+  {
+    props: {
+      // These props were automatically mapped based on your linked code:
+      disabled: figma.enum('State', {
+        Disabled: true,
+      }),
+      loading: figma.enum('State', {
+        Loading: true,
+      }),
+      size: figma.enum('Size', {
+        'SM-20': 'sm',
+        'MD-24': 'md',
+      }),
+      inverted: figma.boolean('Inverted?'),
+      'aria-disabled': figma.enum('State', {
+        Disabled: true,
+      }),
+      focusable: figma.enum('State', {
+        Focus: true,
+      }),
+      // No matching props could be found for these Figma properties:
+      // "icon24": figma.instance('Icon-24'),
+      // "icon20": figma.instance('Icon-20')
+    },
+    example: props => (
+      <UnstyledIconButton
+        disabled={props.disabled}
+        icon={null}
+        loading={props.loading}
+        size={props.size}
+        inverted={props.inverted}
+        focusable={props.focusable}
+      />
+    ),
+  }
+);

package/src/components/UnstyledIconButton/UnstyledIconButtonRoot.tsx

@@ -36,7 +36,7 @@ const styles = StyleSheet.create(theme => ({
     alignItems: 'center',
     borderRadius: theme.borderRadius.sm,
     _web: {
-      '_focus-visible': theme.helpers.focusVisible,
+      // '_focus-visible': theme.helpers.focusVisible,
     },
     variants: {
       disabled: {

package/src/components/VerificationInput/VerificationInput.docs.mdx

@@ -0,0 +1,68 @@
+import { Canvas, Controls, Meta } from '@storybook/addon-docs/blocks';
+import { InfoMediumIcon } from '@utilitywarehouse/hearth-react-native-icons';
+import { VerificationInput } from '../../';
+import { BackToTopButton, UsageWrap, ViewFigmaButton } from '../../../docs/components';
+import * as Stories from './VerificationInput.stories';
+
+<Meta title="Forms / Verification Input" />
+
+<BackToTopButton />
+
+<ViewFigmaButton url="https://www.figma.com/design/6NKZXZhFSExXrcbBgc6zTR/Hearth-Components---Tokens?node-id=4049-3615&t=m0WHtPBmyE9YVP8Q-0" />
+
+# Verification Input
+
+The verification input component is used to capture OTP (One Time Password) or other verification codes.
+
+- [Playground](#playground)
+- [Usage](#usage)
+- [Props](#props)
+- [Variants](#variants)
+  - [States](#states)
+  - [Secure Text Entry](#secure-text-entry)
+
+## Playground
+
+<Canvas of={Stories.Playground} />
+
+<Controls of={Stories.Playground} />
+
+## Usage
+
+<UsageWrap>
+  <VerificationInput label="Enter Code" onChangeText={code => console.log(code)} />
+</UsageWrap>
+
+```tsx
+import { VerificationInput } from '@utilitywarehouse/hearth-react-native';
+
+const MyComponent = () => {
+  const [code, setCode] = useState('');
+
+  return <VerificationInput label="Enter Code" value={code} onChangeText={setCode} />;
+};
+```
+
+## Props
+
+### `VerificationInput`
+
+The component accepts the following props:
+
+| Prop               | Type                                | Default     | Description                                                  |
+| :----------------- | :---------------------------------- | :---------- | :----------------------------------------------------------- |
+| `value`            | `string`                            | -           | The value of the input.                                      |
+| `onChangeText`     | `(text: string) => void`            | -           | Callback when the value changes.                             |
+| `label`            | `string`                            | -           | The label for the input.                                     |
+| `helperText`       | `string`                            | -           | Helper text to display below the input.                      |
+| `helperIcon`       | `ComponentType`                     | -           | Icon to display alongside the helper text.                   |
+| `validationStatus` | `'initial' \| 'valid' \| 'invalid'` | `'initial'` | The validation status of the input.                          |
+| `validText`        | `string`                            | -           | Text to display when validation status is 'valid'.           |
+| `invalidText`      | `string`                            | -           | Text to display when validation status is 'invalid'.         |
+| `disabled`         | `boolean`                           | `false`     | Whether the input is disabled.                               |
+| `readonly`         | `boolean`                           | `false`     | Whether the input is read-only.                              |
+| `secureTextEntry`  | `boolean`                           | `false`     | Whether to obscure the text entry (e.g. for passwords/OTPs). |
+
+## Variants
+
+<Canvas of={Stories.Variants} />

package/src/components/VerificationInput/VerificationInput.props.ts

@@ -0,0 +1,52 @@
+import type { ComponentType } from 'react';
+import { ViewProps } from 'react-native';
+
+export interface VerificationInputProps extends ViewProps {
+  /**
+   * The value of the input.
+   */
+  value?: string;
+  /**
+   * Callback when the value changes.
+   */
+  onChangeText?: (text: string) => void;
+  /**
+   * The label for the input.
+   */
+  label?: string;
+  /**
+   * Helper text to display below the input.
+   */
+  helperText?: string;
+  /**
+   * Icon to display alongside the helper text.
+   */
+  helperIcon?: ComponentType;
+  /**
+   * The validation status of the input.
+   */
+  validationStatus?: 'initial' | 'valid' | 'invalid';
+  /**
+   * Text to display when validation status is 'valid'.
+   */
+  validText?: string;
+  /**
+   * Text to display when validation status is 'invalid'.
+   */
+  invalidText?: string;
+  /**
+   * Whether the input is disabled.
+   */
+  disabled?: boolean;
+  /**
+   * Whether the input is read-only.
+   */
+  readonly?: boolean;
+  /**
+   * Whether to obscure the text entry (e.g. for passwords/OTPs).
+   */
+  secureTextEntry?: boolean;
+}
+
+export default VerificationInputProps;
+

package/src/components/VerificationInput/VerificationInput.stories.tsx

@@ -0,0 +1,140 @@
+import { Meta, StoryObj } from '@storybook/react-vite';
+import { InfoMediumIcon } from '@utilitywarehouse/hearth-react-native-icons';
+import React, { useState } from 'react';
+import { VerificationInput } from '.';
+import { VariantTitle } from '../../../docs/components';
+import { Flex } from '../Flex';
+
+const meta = {
+  title: 'Stories / VerificationInput',
+  component: VerificationInput,
+  parameters: {
+    layout: 'centered',
+  },
+  argTypes: {
+    value: { control: 'text' },
+    label: { control: 'text' },
+    helperText: { control: 'text' },
+    validationStatus: {
+      control: 'select',
+      options: ['initial', 'valid', 'invalid'],
+    },
+    validText: { control: 'text' },
+    invalidText: { control: 'text' },
+    disabled: { control: 'boolean' },
+    readonly: { control: 'boolean' },
+    secureTextEntry: { control: 'boolean' },
+  },
+  args: {
+    label: 'Verification Code',
+    validationStatus: 'initial',
+  },
+} satisfies Meta<typeof VerificationInput>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Playground: Story = {
+  render: args => {
+    const [value, setValue] = useState(args.value || '');
+    return (
+      <VerificationInput
+        {...args}
+        value={value}
+        onChangeText={text => {
+          setValue(text);
+          args.onChangeText?.(text);
+        }}
+      />
+    );
+  },
+};
+
+export const Variants: Story = {
+  parameters: {
+    controls: { include: [] },
+  },
+  render: () => {
+    const [values, setValues] = useState({
+      default: '',
+      filled: '123456',
+      invalid: '123',
+      valid: '123456',
+      disabled: '',
+      secure: '123',
+    });
+
+    const updateValue = (key: keyof typeof values) => (text: string) => {
+      setValues(prev => ({ ...prev, [key]: text }));
+    };
+
+    return (
+      <Flex direction="column" space="lg" style={{ width: 400 }}>
+        <VariantTitle title="Default">
+          <VerificationInput
+            label="Verification Code"
+            helperText="Enter the code sent to your phone"
+            value={values.default}
+            onChangeText={updateValue('default')}
+          />
+        </VariantTitle>
+
+        <VariantTitle title="Filled">
+          <VerificationInput
+            label="Filled Input"
+            value={values.filled}
+            onChangeText={updateValue('filled')}
+          />
+        </VariantTitle>
+
+        <VariantTitle title="Invalid">
+          <VerificationInput
+            label="Invalid Input"
+            validationStatus="invalid"
+            invalidText="The code you entered is incorrect"
+            value={values.invalid}
+            onChangeText={updateValue('invalid')}
+          />
+        </VariantTitle>
+
+        <VariantTitle title="Valid">
+          <VerificationInput
+            label="Valid Input"
+            validationStatus="valid"
+            validText="Code verified!"
+            value={values.valid}
+            onChangeText={updateValue('valid')}
+          />
+        </VariantTitle>
+
+        <VariantTitle title="Disabled">
+          <VerificationInput
+            label="Disabled Input"
+            disabled
+            value={values.disabled}
+            onChangeText={updateValue('disabled')}
+          />
+        </VariantTitle>
+
+        <VariantTitle title="Secure Text Entry">
+          <VerificationInput
+            label="Secure Input"
+            secureTextEntry
+            value={values.secure}
+            onChangeText={updateValue('secure')}
+          />
+        </VariantTitle>
+
+        <VariantTitle title="With Helper Icon">
+          <VerificationInput
+            label="Helper Icon"
+            helperText="Some information"
+            helperIcon={InfoMediumIcon}
+            value={values.default}
+            onChangeText={updateValue('default')}
+          />
+        </VariantTitle>
+      </Flex>
+    );
+  },
+};

package/src/components/VerificationInput/VerificationInput.tsx

@@ -0,0 +1,89 @@
+import { View } from 'react-native';
+import { StyleSheet } from 'react-native-unistyles';
+import { FormField } from '../FormField';
+import { useVerificationInput } from './useVerificationInput';
+import VerificationInputProps from './VerificationInput.props';
+import { VerificationInputSlot } from './VerificationInputSlot';
+
+const VerificationInput = ({
+  value = '',
+  onChangeText,
+  label,
+  helperText,
+  helperIcon,
+  validationStatus = 'initial',
+  validText,
+  invalidText,
+  disabled = false,
+  readonly = false,
+  secureTextEntry = false,
+  style,
+  ...props
+}: VerificationInputProps) => {
+  const length = 6;
+  const { inputRefs, focusedIndex, handleFocus, handleBlur, handleChangeText, handleKeyPress } =
+    useVerificationInput({
+      value,
+      onChangeText,
+    });
+
+  const slots = Array.from({ length }, (_, index) => index);
+
+  return (
+    <FormField
+      label={label}
+      helperText={helperText}
+      helperIcon={helperIcon}
+      validationStatus={validationStatus}
+      validText={validText}
+      invalidText={invalidText}
+      disabled={disabled}
+      readonly={readonly}
+      style={[styles.root, style]}
+      {...props}
+    >
+      <View style={styles.slotsContainer}>
+        {slots.map(index => {
+          const char = value[index] || '';
+          const isActive = focusedIndex === index;
+
+          return (
+            <VerificationInputSlot
+              key={index}
+              ref={ref => {
+                inputRefs.current[index] = ref;
+              }}
+              value={char}
+              isActive={isActive}
+              validationStatus={validationStatus}
+              disabled={disabled}
+              readonly={readonly}
+              secureTextEntry={secureTextEntry}
+              onChangeText={text => handleChangeText(text, index)}
+              onKeyPress={e => handleKeyPress(e, index)}
+              onFocus={() => handleFocus(index)}
+              onBlur={handleBlur}
+            />
+          );
+        })}
+      </View>
+    </FormField>
+  );
+};
+
+const styles = StyleSheet.create(theme => ({
+  root: {
+    gap: theme.components.input.verification.gap,
+    width: '100%',
+    maxWidth: theme.components.input.maxWidth,
+  },
+  slotsContainer: {
+    flexDirection: 'row',
+    gap: theme.components.input.verification.gap,
+    width: '100%',
+  },
+}));
+
+VerificationInput.displayName = 'VerificationInput';
+
+export default VerificationInput;

package/src/components/VerificationInput/VerificationInputSlot.tsx

@@ -0,0 +1,94 @@
+import { forwardRef } from 'react';
+import { TextInput, TextInputProps } from 'react-native';
+import { StyleSheet } from 'react-native-unistyles';
+import InputField from '../Input/InputField';
+
+interface VerificationInputSlotProps extends TextInputProps {
+  isActive: boolean;
+  validationStatus: 'initial' | 'valid' | 'invalid';
+  disabled?: boolean;
+  readonly?: boolean;
+}
+
+export const VerificationInputSlot = forwardRef<TextInput, VerificationInputSlotProps>(
+  ({ isActive, validationStatus, disabled, readonly, style, ...props }, ref) => {
+    styles.useVariants({
+      disabled,
+      readonly,
+      validationStatus,
+      active: isActive,
+    });
+
+    return (
+      <InputField
+        ref={ref}
+        {...props}
+        editable={!disabled && !readonly}
+        selectTextOnFocus
+        keyboardType="number-pad"
+        style={[styles.slot, style]}
+      />
+    );
+  }
+);
+
+VerificationInputSlot.displayName = 'VerificationInputSlot';
+
+const styles = StyleSheet.create(theme => ({
+  slot: {
+    flex: 0,
+    width: theme.components.input.height,
+    height: theme.components.input.height,
+    borderWidth: theme.components.input.borderWidth,
+    borderColor: theme.color.border.strong,
+    borderRadius: theme.components.input.borderRadius,
+    backgroundColor: theme.color.surface.neutral.strong,
+    textAlign: 'center',
+    padding: 0,
+    variants: {
+      disabled: {
+        true: {
+          opacity: theme.opacity.disabled,
+          color: theme.color.text.secondary,
+        },
+      },
+      readonly: {
+        true: {
+          borderColor: theme.color.border.subtle,
+          backgroundColor: theme.color.surface.neutral.subtle,
+        },
+      },
+      validationStatus: {
+        initial: {},
+        valid: {
+          borderColor: theme.color.feedback.positive.border,
+        },
+        invalid: {
+          borderColor: theme.color.feedback.danger.border,
+        },
+      },
+      active: {
+        true: {
+          borderColor: theme.color.border.strong,
+          borderWidth: theme.components.input.borderWidthFocused,
+        },
+      },
+    },
+    compoundVariants: [
+      {
+        validationStatus: 'invalid',
+        active: true,
+        styles: {
+          borderColor: theme.color.feedback.danger.border,
+        },
+      },
+      {
+        validationStatus: 'valid',
+        active: true,
+        styles: {
+          borderColor: theme.color.border.strong,
+        },
+      },
+    ],
+  },
+}));

package/src/components/VerificationInput/index.ts

@@ -0,0 +1,5 @@
+import VerificationInput from './VerificationInput';
+export { default as VerificationInput } from './VerificationInput';
+export type { default as VerificationInputProps } from './VerificationInput.props';
+export default VerificationInput;
+