@utilitywarehouse/hearth-react-native 0.1.0 → 0.3.0

package/src/components/IconButton/IconButtonSpinner.tsx

@@ -8,49 +8,46 @@ import { useIconButtonContext } from './IconButton.context';
 const IconButtonSpinner = (props: Omit<SpinnerProps, 'size'>) => {
   const { color = '', ...rest } = props;
   const { colorScheme, variant, disabled, inverted, size } = useIconButtonContext();
-  const { components, colorMode } = useTheme();
+  const { color: themeColor, colorMode } = useTheme();
   const colorProp = useMemo(() => {
-    if (variant === 'emphasis' && colorScheme === 'yellow' && inverted) {
-      return components.button.emphasis.yellow.foregroundColor;
+    if (variant === 'emphasis' && colorScheme === 'highlight') {
+      return themeColor.interactive.highlight.foreground.strong;
     }
-    if (variant === 'emphasis' && colorScheme === 'yellow') {
-      return components.button.emphasis.yellow.foregroundColor;
+    if (variant === 'solid' && colorScheme === 'highlight') {
+      return themeColor.interactive.highlight.foreground.strong;
     }
-    if (variant === 'solid' && colorScheme === 'yellow' && inverted) {
-      return components.button.solid.yellow.inverted.foregroundColor;
+    if (variant === 'solid' && colorScheme === 'destructive') {
+      return themeColor.interactive.destructive.foreground.strong;
     }
-    if (variant === 'solid' && colorScheme === 'yellow') {
-      return components.button.solid.yellow.foregroundColor;
+    if (variant === 'solid' && colorScheme === 'affirmative') {
+      return themeColor.interactive.affirmative.foreground.strong;
     }
-    if (variant === 'solid' && colorScheme === 'red') {
-      return components.button.solid.red.foregroundColor;
+    if (variant === 'outline' && colorScheme === 'destructive') {
+      return themeColor.interactive.destructive.foreground.subtle;
     }
-    if (variant === 'solid' && colorScheme === 'green') {
-      return components.button.solid.green.foregroundColor;
+    if (variant === 'outline' && colorScheme === 'affirmative') {
+      return themeColor.interactive.affirmative.foreground.subtle;
     }
-    if (variant === 'outline' && colorScheme === 'red') {
-      return components.button.outline.red.foregroundColor;
+    if (variant === 'outline' && colorScheme === 'functional' && inverted) {
+      return themeColor.interactive.functional.foreground.strong;
     }
-    if (variant === 'outline' && colorScheme === 'green') {
-      return components.button.outline.green.foregroundColor;
+    if (variant === 'outline' && colorScheme === 'functional') {
+      return themeColor.interactive.functional.foreground.subtle;
     }
-    if (variant === 'outline' && colorScheme === 'grey' && inverted) {
-      return components.button.outline.grey.inverted.foregroundColor;
+    if (variant === 'ghost' && colorScheme === 'destructive') {
+      return themeColor.interactive.destructive.foreground.subtle;
     }
-    if (variant === 'outline' && colorScheme === 'grey') {
-      return components.button.outline.grey.foregroundColor;
+    if (variant === 'ghost' && colorScheme === 'affirmative') {
+      return themeColor.interactive.affirmative.foreground.subtle;
     }
-    if (variant === 'ghost' && colorScheme === 'red') {
-      return components.button.ghost.red.foregroundColor;
+    if (variant === 'ghost' && colorScheme === 'functional' && inverted) {
+      return themeColor.interactive.functional.foreground.strong;
     }
-    if (variant === 'ghost' && colorScheme === 'green') {
-      return components.button.ghost.green.foregroundColor;
+    if (variant === 'ghost' && colorScheme === 'functional') {
+      return themeColor.interactive.functional.foreground.subtle;
     }
-    if (variant === 'ghost' && colorScheme === 'grey' && inverted) {
-      return components.button.ghost.grey.inverted.foregroundColor;
-    }
-    if (variant === 'ghost' && colorScheme === 'grey') {
-      return components.button.ghost.grey.foregroundColor;
+    if (variant === 'ghost' && colorScheme === 'destructive') {
+      return themeColor.interactive.destructive.foreground.subtle;
     }
     return color;
     // eslint-disable-next-line react-hooks/exhaustive-deps

package/src/components/IconContainer/IconContainer.docs.mdx

@@ -0,0 +1,90 @@
+import { Canvas, Controls, Meta, Story } from '@storybook/addon-docs/blocks';
+import {
+  BroadbandMediumIcon,
+  CashbackCardMediumIcon,
+  ConfettiMediumIcon,
+  ElectricityMediumIcon,
+  InsuranceMediumIcon,
+  MobileMediumIcon,
+} from '@utilitywarehouse/hearth-react-native-icons';
+import { Center, Flex, IconContainer } from '../../';
+import { BackToTopButton, UsageWrap } from '../../../docs/components';
+import * as Stories from './IconContainer.stories';
+
+<BackToTopButton />
+
+<Meta title="Components / Icon Container" />
+
+# Icon Container
+
+The `IconContainer` component provides a consistent background and sizing (via component tokens) for any standalone icon, with semantic colour families and subtle/emphasis variants.
+
+- [Playground](#playground)
+- [Usage](#usage)
+- [Props](#props)
+- [Variants](#variants)
+
+## Playground
+
+<Canvas of={Stories.Playground} />
+
+<Controls of={Stories.Playground} />
+
+## Usage
+
+Wrap an icon with the `IconContainer` to apply sizing + background styles without repeating layout code.
+
+<UsageWrap>
+  <Center>
+    <Flex direction="row" space="lg" alignItems="center">
+      <IconContainer icon={ElectricityMediumIcon} size="md" variant="emphasis" color="energy" />
+      <IconContainer icon={BroadbandMediumIcon} size="md" variant="emphasis" color="broadband" />
+      <IconContainer icon={MobileMediumIcon} size="md" variant="emphasis" color="mobile" />
+      <IconContainer icon={InsuranceMediumIcon} size="md" variant="emphasis" color="insurance" />
+      <IconContainer icon={CashbackCardMediumIcon} size="md" variant="emphasis" color="cashback" />
+      <IconContainer icon={ConfettiMediumIcon} size="md" variant="emphasis" color="pig" />
+    </Flex>
+  </Center>
+</UsageWrap>
+
+```jsx
+import { IconContainer } from '@utilitywarehouse/hearth-react-native';
+import {
+  ElectricityMediumIcon,
+  BroadbandMediumIcon,
+  MobileMediumIcon,
+  InsuranceMediumIcon,
+  CashbackCardMediumIcon,
+  ConfettiMediumIcon,
+} from '@utilitywarehouse/hearth-react-native-icons';
+
+const MyComponent = () => (
+  <>
+    <IconContainer icon={ElectricityMediumIcon} size="md" variant="emphasis" color="energy" />
+    <IconContainer icon={BroadbandMediumIcon} size="md" variant="emphasis" color="broadband" />
+    <IconContainer icon={MobileMediumIcon} size="md" variant="emphasis" color="mobile" />
+    <IconContainer icon={InsuranceMediumIcon} size="md" variant="emphasis" color="insurance" />
+    <IconContainer icon={CashbackCardMediumIcon} size="md" variant="emphasis" color="cashback" />
+    <IconContainer icon={ConfettiMediumIcon} size="md" variant="emphasis" color="pig" />
+  </>
+);
+```
+
+## Props
+
+| Name         | Type                                                                                               | Description                                     | Default    |
+| ------------ | -------------------------------------------------------------------------------------------------- | ----------------------------------------------- | ---------- |
+| `icon`       | `React.ComponentType`                                                                              | Icon component rendered inside the container    | (required) |
+| `size`       | `'sm' \| 'md' \| 'lg'`                                                                             | Size variant (token-based width/height/padding) | `md`       |
+| `radiusNone` | `boolean`                                                                                          | Remove border radius (square container)         | `false`    |
+| `variant`    | `'subtle' \| 'emphasis'`                                                                           | Background emphasis level                       | `subtle`   |
+| `color`      | `'pig' \| 'energy' \| 'broadband' \| 'mobile' \|` <br />`'insurance' \| 'cashback' \| 'highlight'` | Semantic colour family for surface tokens       | `pig`      |
+| `...View`    | React Native `ViewProps`                                                                           | Any additional View props                       | -          |
+
+> Colours resolve to `theme.color.surface.<family>.{subtle|default}` depending on variant.
+
+## Variants
+
+Use the matrix below to compare every combination of size, variant, and color.
+
+<Canvas of={Stories.KitchenSink} />

package/src/components/IconContainer/IconContainer.props.ts

@@ -0,0 +1,17 @@
+import type { ComponentType } from 'react';
+import type { ViewProps } from 'react-native';
+
+export interface IconContainerProps extends ViewProps {
+  /** Icon component to render inside the container */
+  icon: ComponentType;
+  /** Size of the container */
+  size?: 'sm' | 'md' | 'lg';
+  /** If true, removes border radius from the container */
+  radiusNone?: boolean;
+  /** Background style of the container */
+  variant?: 'subtle' | 'emphasis';
+  /** Background color token of the container */
+  color?: 'pig' | 'energy' | 'broadband' | 'mobile' | 'insurance' | 'cashback' | 'highlight';
+}
+
+export default IconContainerProps;

package/src/components/IconContainer/IconContainer.stories.tsx

@@ -0,0 +1,130 @@
+import { Meta, StoryObj } from '@storybook/react-vite';
+import * as Icons from '@utilitywarehouse/hearth-react-native-icons';
+import { IconContainer } from '.';
+import { VariantTitle } from '../../../docs/components';
+import { Box } from '../Box';
+import { Flex } from '../Flex';
+
+type IconKey = keyof typeof Icons;
+
+const meta: Meta<typeof IconContainer> = {
+  title: 'Stories / IconContainer',
+  component: IconContainer,
+  parameters: {
+    layout: 'centered',
+  },
+  argTypes: {
+    icon: {
+      control: 'select',
+      options: Object.keys(Icons),
+      mapping: Icons,
+      description: 'Icon component rendered inside the container',
+    },
+    size: {
+      control: 'select',
+      options: ['sm', 'md', 'lg'],
+      description: 'Size variant',
+    },
+    radiusNone: {
+      control: 'boolean',
+      description: 'Remove border radius (square edges)',
+    },
+    variant: {
+      control: 'select',
+      options: ['subtle', 'emphasis'],
+      description: 'Background emphasis style',
+    },
+    color: {
+      control: 'select',
+      options: ['pig', 'energy', 'broadband', 'mobile', 'insurance', 'cashback', 'highlight'],
+      description: 'Semantic color surface family',
+    },
+  },
+  args: {
+    icon: Icons[Object.keys(Icons)[0] as IconKey],
+    size: 'md',
+    radiusNone: false,
+    variant: 'subtle',
+    color: 'pig',
+  },
+};
+
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Playground: Story = { render: args => <IconContainer {...args} /> };
+
+export const Subtle: Story = {
+  parameters: {
+    controls: { exclude: ['variant'] },
+  },
+  args: {
+    variant: 'subtle',
+  },
+};
+
+export const Emphasis: Story = {
+  parameters: {
+    controls: { exclude: ['variant'] },
+  },
+  args: {
+    variant: 'emphasis',
+  },
+};
+
+export const RadiusNone: Story = {
+  parameters: {
+    controls: { exclude: ['radiusNone'] },
+  },
+  args: {
+    radiusNone: true,
+  },
+};
+
+export const KitchenSink: Story = {
+  parameters: {
+    controls: { exclude: ['radiusNone', 'variant', 'color', 'size'] },
+  },
+  render: ({ icon }) => {
+    const sizes: Array<'sm' | 'md' | 'lg'> = ['sm', 'md', 'lg'];
+    const colors: Array<
+      'pig' | 'energy' | 'broadband' | 'mobile' | 'insurance' | 'cashback' | 'highlight'
+    > = ['pig', 'energy', 'broadband', 'mobile', 'insurance', 'cashback', 'highlight'];
+    return (
+      <Flex direction="column" space="lg">
+        {sizes.map(size => (
+          <Box key={size} gap="300">
+            <VariantTitle title={`Size: ${size.toUpperCase()} / Subtle`}> </VariantTitle>
+            <Flex direction="row" wrap="wrap" space="md">
+              {colors.map(color => (
+                <IconContainer
+                  key={`${size}-subtle-${color}`}
+                  icon={icon}
+                  size={size}
+                  variant="subtle"
+                  color={color}
+                />
+              ))}
+            </Flex>
+            <VariantTitle title={`Size: ${size.toUpperCase()} / Emphasis`}> </VariantTitle>
+            <Flex direction="row" wrap="wrap" space="md">
+              {colors.map(
+                color =>
+                  color !== 'highlight' && (
+                    <IconContainer
+                      key={`${size}-emphasis-${color}`}
+                      icon={icon}
+                      size={size}
+                      variant="emphasis"
+                      color={color}
+                    />
+                  )
+              )}
+            </Flex>
+          </Box>
+        ))}
+      </Flex>
+    );
+  },
+};

package/src/components/IconContainer/IconContainer.tsx

@@ -0,0 +1,180 @@
+import { View } from 'react-native';
+import { StyleSheet, withUnistyles } from 'react-native-unistyles';
+import { Icon } from '../Icon';
+import type IconContainerProps from './IconContainer.props';
+
+const IconContainer = withUnistyles(
+  ({
+    icon: IconComp,
+    size = 'md',
+    radiusNone = false,
+    variant = 'subtle',
+    color = 'pig',
+    style,
+    ...props
+  }: IconContainerProps) => {
+    styles.useVariants({ size, radiusNone, variant, color });
+
+    return (
+      <View style={[styles.container, style]} {...props}>
+        {IconComp ? <Icon as={IconComp} style={styles.icon} /> : null}
+      </View>
+    );
+  }
+);
+
+IconContainer.displayName = 'IconContainer';
+
+const styles = StyleSheet.create(theme => ({
+  container: {
+    alignItems: 'center',
+    justifyContent: 'center',
+    overflow: 'hidden',
+    variants: {
+      size: {
+        sm: {
+          width: theme.components.iconContainer.sm.width,
+          height: theme.components.iconContainer.sm.height,
+          padding: theme.components.iconContainer.sm.padding,
+          borderRadius: theme.components.iconContainer.sm.borderRadiusRounded,
+        },
+        md: {
+          width: theme.components.iconContainer.md.width,
+          height: theme.components.iconContainer.md.height,
+          padding: theme.components.iconContainer.md.padding,
+          borderRadius: theme.components.iconContainer.md.borderRadiusRounded,
+        },
+        lg: {
+          width: theme.components.iconContainer.lg.width,
+          height: theme.components.iconContainer.lg.height,
+          padding: theme.components.iconContainer.lg.padding,
+          borderRadius: theme.components.iconContainer.lg.borderRadiusRounded,
+        },
+      },
+      radiusNone: {
+        true: {
+          borderRadius: 0,
+        },
+        false: {},
+      },
+      variant: {
+        subtle: {},
+        emphasis: {},
+      },
+      color: {
+        pig: {},
+        energy: {},
+        broadband: {},
+        mobile: {},
+        insurance: {},
+        cashback: {},
+        highlight: {},
+      },
+    },
+    compoundVariants: [
+      {
+        variant: 'emphasis',
+        color: 'pig',
+        styles: {
+          backgroundColor: theme.color.surface.pig.default,
+        },
+      },
+      {
+        variant: 'subtle',
+        color: 'pig',
+        styles: {
+          backgroundColor: theme.color.surface.pig.subtle,
+        },
+      },
+      {
+        variant: 'emphasis',
+        color: 'energy',
+        styles: {
+          backgroundColor: theme.color.surface.energy.default,
+        },
+      },
+      {
+        variant: 'subtle',
+        color: 'energy',
+        styles: {
+          backgroundColor: theme.color.surface.energy.subtle,
+        },
+      },
+      {
+        variant: 'emphasis',
+        color: 'broadband',
+        styles: {
+          backgroundColor: theme.color.surface.broadband.default,
+        },
+      },
+      {
+        variant: 'subtle',
+        color: 'broadband',
+        styles: {
+          backgroundColor: theme.color.surface.broadband.subtle,
+        },
+      },
+      {
+        variant: 'emphasis',
+        color: 'mobile',
+        styles: {
+          backgroundColor: theme.color.surface.mobile.default,
+        },
+      },
+      {
+        variant: 'subtle',
+        color: 'mobile',
+        styles: {
+          backgroundColor: theme.color.surface.mobile.subtle,
+        },
+      },
+      {
+        variant: 'emphasis',
+        color: 'insurance',
+        styles: {
+          backgroundColor: theme.color.surface.insurance.default,
+        },
+      },
+      {
+        variant: 'subtle',
+        color: 'insurance',
+        styles: {
+          backgroundColor: theme.color.surface.insurance.subtle,
+        },
+      },
+      {
+        variant: 'emphasis',
+        color: 'cashback',
+        styles: {
+          backgroundColor: theme.color.surface.cashback.default,
+        },
+      },
+      {
+        variant: 'subtle',
+        color: 'cashback',
+        styles: {
+          backgroundColor: theme.color.surface.cashback.subtle,
+        },
+      },
+      {
+        variant: 'emphasis',
+        color: 'highlight',
+        styles: {
+          backgroundColor: theme.color.surface.highlight.default,
+        },
+      },
+      {
+        variant: 'subtle',
+        color: 'highlight',
+        styles: {
+          backgroundColor: theme.color.surface.highlight.subtle,
+        },
+      },
+    ],
+  },
+  icon: {
+    color: theme.color.icon.primary,
+  },
+}));
+
+export default IconContainer;

package/src/components/IconContainer/index.tsx

@@ -0,0 +1,2 @@
+export { default as IconContainer } from './IconContainer';
+export type { default as IconContainerProps } from './IconContainer.props';

package/src/components/Icons/CircleIcon.tsx

@@ -1,20 +1,18 @@
 import { createIcon } from '@gluestack-ui/icon';
-import { Svg, Path } from 'react-native-svg';
+import { Path, Svg } from 'react-native-svg';
 
 const CircleIcon = createIcon({
   Root: Svg,
   viewBox: '0 0 24 24',
   path: (
-    <>
-      <Path
-        d="M12 22C17.5228 22 22 17.5228 22 12C22 6.47715 17.5228 2 12 2C6.47715 2 2 6.47715 2 12C2 17.5228 6.47715 22 12 22Z"
-        fill="currentColor"
-        stroke="currentColor"
-        strokeWidth="2"
-        strokeLinecap="round"
-        strokeLinejoin="round"
-      />
-    </>
+    <Path
+      d="M12 22C17.5228 22 22 17.5228 22 12C22 6.47715 17.5228 2 12 2C6.47715 2 2 6.47715 2 12C2 17.5228 6.47715 22 12 22Z"
+      fill="currentColor"
+      stroke="currentColor"
+      strokeWidth="2"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+    />
   ),
 });
 

package/src/components/InlineLink/InlineLinkRoot.tsx

@@ -35,7 +35,7 @@ const styles = StyleSheet.create(theme => ({
         borderRadius: theme.borderRadius.xs,
         outlineStyle: 'solid',
         outlineWidth: 2,
-        outlineColor: theme.components.focus.border,
+        outlineColor: theme.color.focus.primary,
         outlineOffset: 1,
         boxShadow: 'none',
       },
@@ -55,7 +55,7 @@ const styles = StyleSheet.create(theme => ({
           textDecorationColor: theme.components.inlineLink.inverted.color,
           _web: {
             '_focus-visible': {
-              outlineColor: theme.components.focus.borderInverted,
+              outlineColor: theme.color.focus.inverted,
             },
           },
         },

package/src/components/Input/Input.docs.mdx

@@ -1,13 +1,13 @@
-import { Meta, Controls, Story, Canvas } from '@storybook/addon-docs/blocks';
-import * as Stories from './Input.stories';
-import { Input, InputField, InputIcon, InputSlot, Center, Pressable, FormField } from '../../';
+import { Canvas, Controls, Meta, Story } from '@storybook/addon-docs/blocks';
 import { EmailMediumIcon } from '@utilitywarehouse/hearth-react-native-icons';
+import { Center, FormField, Input, InputField, InputIcon, InputSlot, Pressable } from '../../';
 import {
-  ViewFigmaButton,
+  AdvancedInputExample,
   BackToTopButton,
   UsageWrap,
-  AdvancedInputExample,
+  ViewFigmaButton,
 } from '../../../docs/components';
+import * as Stories from './Input.stories';
 
 <Meta title="Forms / Input" />
 
@@ -57,12 +57,12 @@ import { EmailMediumIcon } from '@utilitywarehouse/hearth-react-native-icons';
 
 const MyComponent = () => {
   const [value, setValue] = useState('');
-  const handleChange = e => {
-    setValue(e.target.value);
+  const handleChange = val => {
+    setValue(val);
   };
   return (
     <Input
-      onChange={handleChange}
+      onChangeText={handleChange}
       value={value}
       placeholder="Placeholder"
       leadingIcon={EmailMediumIcon}
@@ -94,6 +94,7 @@ all of the React Native [`View` props](https://reactnative.dev/docs/view).
 | onFocus          | function                           | `-`         | Callback function that is triggered when the input gains focus. **(Only to be used if the input has no children)**                                                      |
 | placeholder      | string                             | `-`         | The placeholder text for the input. **(Only to be used if the input has no children)**                                                                                  |
 | required         | boolean                            | `true`      | Indicates that the input is required. **(Only to be used if the input has no children)**                                                                                |
+| inBottomSheet    | boolean                            | `false`     | Indicates if the input is within a bottom sheet.                                                                                                                        |
 
 If the `leadingIcon` or `trailingIcon` props are used, the `Input` component should not have any children.
 
@@ -101,15 +102,16 @@ If the `leadingIcon` or `trailingIcon` props are used, the `Input` component sho
 
 The `InputField` inherits all of the React Native [`TextInput` props](https://reactnative.dev/docs/textinput).
 
-| Prop        | Type                   | Default  | Description                                                       |
-| ----------- | ---------------------- | -------- | ----------------------------------------------------------------- |
-| type        | `'text' \| 'password'` | `'text'` | The type of the input.                                            |
-| value       | string                 | `-`      | The value of the input.                                           |
-| onChange    | function               | `-`      | Callback function that is triggered when the input value changes. |
-| onBlur      | function               | `-`      | Callback function that is triggered when the input loses focus.   |
-| onFocus     | function               | `-`      | Callback function that is triggered when the input gains focus.   |
-| placeholder | string                 | `-`      | The placeholder text for the input.                               |
-| required    | boolean                | `true`   | Indicates that the input is required.                             |
+| Prop          | Type                   | Default  | Description                                                       |
+| ------------- | ---------------------- | -------- | ----------------------------------------------------------------- |
+| type          | `'text' \| 'password'` | `'text'` | The type of the input.                                            |
+| value         | string                 | `-`      | The value of the input.                                           |
+| onChange      | function               | `-`      | Callback function that is triggered when the input value changes. |
+| onBlur        | function               | `-`      | Callback function that is triggered when the input loses focus.   |
+| onFocus       | function               | `-`      | Callback function that is triggered when the input gains focus.   |
+| placeholder   | string                 | `-`      | The placeholder text for the input.                               |
+| required      | boolean                | `true`   | Indicates that the input is required.                             |
+| inBottomSheet | boolean                | `false`  | Indicates if the input is within a bottom sheet.                  |
 
 ### `InputIcon`
 

package/src/components/Input/Input.props.ts

@@ -26,6 +26,7 @@ export interface InputBaseProps {
   readonly?: boolean;
   focused?: boolean;
   placeholder?: string;
+  inBottomSheet?: boolean;
 }
 
 // For inputs that have children
@@ -69,24 +70,6 @@ interface PasswordInputSpecificProps extends InputWithoutChildrenBaseProps {
   onClear?: never;
 }
 
-interface DateInputSpecificProps extends InputWithoutChildrenBaseProps {
-  type: 'date';
-  format?: string;
-  showPasswordToggle?: never;
-  loading?: never;
-  clearable?: never;
-  onClear?: never;
-}
-
-interface CurrencyInputSpecificProps extends InputWithoutChildrenBaseProps {
-  type: 'currency';
-  format?: string;
-  showPasswordToggle?: never;
-  loading?: never;
-  clearable?: never;
-  onClear?: never;
-}
-
 interface SearchInputSpecificProps extends InputWithoutChildrenBaseProps {
   type: 'search';
   loading?: boolean;
@@ -100,8 +83,6 @@ interface SearchInputSpecificProps extends InputWithoutChildrenBaseProps {
 export type InputWithoutChildrenProps =
   | TextInputSpecificProps
   | PasswordInputSpecificProps
-  | DateInputSpecificProps
-  | CurrencyInputSpecificProps
   | SearchInputSpecificProps;
 
 /**