@momo-kits/foundation 0.77.8 → 0.78.2

package/Input/InputTextArea.tsx

@@ -1,4 +1,4 @@
-import React, {FC, useContext, useRef, useState} from 'react';
+import React, {forwardRef, useContext, useRef, useState} from 'react';
 import {
   NativeSyntheticEvent,
   TextInput,
@@ -19,134 +19,142 @@ import {InputTextAreaProps} from './index';
 import {Icon} from '../Icon';
 import {ApplicationContext} from '../Application';
 
-const InputTextArea: FC<InputTextAreaProps> = ({
-  errorMessage,
-  onChangeText,
-  floatingIconColor,
-  floatingIcon,
-  floatingValue,
-  onFocus,
-  onBlur,
-  disabled,
-  value,
-  defaultValue,
-  height,
-  placeholder,
-  maxLength,
-  required,
-  ...props
-}) => {
-  const {theme} = useContext(ApplicationContext);
-  const [focused, setFocused] = useState(false);
-  const [inputValue, setInputValue] = useState(defaultValue ?? '');
-  const inputRef = useRef<any>(null);
+const InputTextArea = forwardRef(
+  (
+    {
+      errorMessage,
+      onChangeText,
+      floatingIconColor,
+      floatingIcon,
+      floatingValue,
+      onFocus,
+      onBlur,
+      disabled,
+      value,
+      defaultValue,
+      height,
+      placeholder,
+      maxLength,
+      required,
+      errorSpacing,
+      ...props
+    }: InputTextAreaProps,
+    ref,
+  ) => {
+    const {theme} = useContext(ApplicationContext);
+    const [focused, setFocused] = useState(false);
+    const [inputValue, setInputValue] = useState(defaultValue ?? '');
+    const inputRef = (ref as React.RefObject<TextInput>) ?? useRef<TextInput>();
 
-  const onClearText = () => {
-    inputRef?.current?.clear();
-    _onChangeText('');
-  };
+    const onClearText = () => {
+      inputRef?.current?.clear();
+      _onChangeText('');
+    };
 
-  const _onChangeText = (text: string) => {
-    onChangeText?.(text);
-    setInputValue(text);
-  };
+    const _onChangeText = (text: string) => {
+      onChangeText?.(text);
+      setInputValue(text);
+    };
 
-  const _onFocus = (e: NativeSyntheticEvent<TextInputFocusEventData>) => {
-    setFocused(true);
-    onFocus?.(e);
-  };
+    const _onFocus = (e: NativeSyntheticEvent<TextInputFocusEventData>) => {
+      setFocused(true);
+      onFocus?.(e);
+    };
 
-  const _onBlur = (e: NativeSyntheticEvent<TextInputFocusEventData>) => {
-    setFocused(false);
-    onBlur?.(e);
-  };
+    const _onBlur = (e: NativeSyntheticEvent<TextInputFocusEventData>) => {
+      setFocused(false);
+      onBlur?.(e);
+    };
 
-  const renderCountingView = () => {
-    return (
-      <View style={styles.countingView}>
-        <Text color={theme.colors.text.hint} typography={'description_xs'}>
-          {`${inputValue.length}/${maxLength}`}
-        </Text>
-      </View>
-    );
-  };
-  const renderInputView = () => {
-    const disabledColor = theme.colors.text.disable;
-    let textColor = theme.colors.text.default;
-    let placeholderColor = theme.colors.text.hint;
+    const renderCountingView = () => {
+      return (
+        <View style={styles.countingView}>
+          <Text color={theme.colors.text.hint} typography={'description_xs'}>
+            {`${inputValue.length}/${maxLength}`}
+          </Text>
+        </View>
+      );
+    };
+    const renderInputView = () => {
+      const disabledColor = theme.colors.text.disable;
+      let textColor = theme.colors.text.default;
+      let placeholderColor = theme.colors.text.hint;
 
-    if (disabled) {
-      textColor = disabledColor;
-      placeholderColor = disabledColor;
-    }
+      if (disabled) {
+        textColor = disabledColor;
+        placeholderColor = disabledColor;
+      }
 
-    return (
-      <View
-        style={[
-          getBorderColor(focused, errorMessage, disabled),
-          styles.textAreaWrapper,
-          {
-            height: height || DEFAULT_HEIGHT,
-            backgroundColor: theme.colors.background.surface,
-          },
-        ]}>
-        <FloatingView
-          floatingValue={floatingValue}
-          floatingIconColor={floatingIconColor}
-          disabled={disabled}
-          floatingIcon={floatingIcon}
-          required={required}
-        />
-        <View style={styles.rowArea}>
-          <View style={styles.textAreaView}>
-            <TextInput
-              {...props}
-              accessibilityLabel={`TextInput`}
-              ref={inputRef}
-              editable={!disabled}
-              textAlignVertical="top"
-              style={[
-                styles.textArea,
-                {
-                  color: textColor,
-                },
-              ]}
-              maxLength={maxLength}
-              textBreakStrategy="highQuality"
-              multiline={true}
-              value={value}
-              onChangeText={_onChangeText}
-              onFocus={_onFocus}
-              onBlur={_onBlur}
-              placeholder={placeholder}
-              selectionColor={theme.colors.primary}
-              placeholderTextColor={placeholderColor}
-            />
-          </View>
-          {focused && inputValue.length > 0 && (
-            <TouchableOpacity style={styles.iconWrapper} onPress={onClearText}>
-              <Icon
-                source="24_navigation_close_circle_full"
-                size={16}
-                color={theme.colors.text.hint}
+      return (
+        <View
+          style={[
+            styles.textAreaWrapper,
+            {
+              height: height || DEFAULT_HEIGHT,
+              backgroundColor: theme.colors.background.surface,
+            },
+            getBorderColor(theme, focused, errorMessage, disabled),
+          ]}>
+          <FloatingView
+            floatingValue={floatingValue}
+            floatingIconColor={floatingIconColor}
+            disabled={disabled}
+            floatingIcon={floatingIcon}
+            required={required}
+          />
+          <View style={styles.rowArea}>
+            <View style={styles.textAreaView}>
+              <TextInput
+                {...props}
+                accessibilityLabel={`TextInput`}
+                ref={inputRef}
+                editable={!disabled}
+                textAlignVertical="top"
+                style={[
+                  styles.textArea,
+                  {
+                    color: textColor,
+                  },
+                ]}
+                maxLength={maxLength}
+                textBreakStrategy="highQuality"
+                multiline={true}
+                value={value}
+                onChangeText={_onChangeText}
+                onFocus={_onFocus}
+                onBlur={_onBlur}
+                placeholder={placeholder}
+                selectionColor={theme.colors.primary}
+                placeholderTextColor={placeholderColor}
               />
-            </TouchableOpacity>
-          )}
+            </View>
+            {focused && inputValue.length > 0 && (
+              <TouchableOpacity
+                style={styles.iconWrapper}
+                onPress={onClearText}>
+                <Icon
+                  source="24_navigation_close_circle_full"
+                  size={16}
+                  color={theme.colors.text.hint}
+                />
+              </TouchableOpacity>
+            )}
+          </View>
+          {renderCountingView()}
         </View>
-        {renderCountingView()}
+      );
+    };
+
+    return (
+      <View
+        style={styles.wrapper}
+        accessibilityLabel={`InputTextArea/${floatingValue}`}>
+        {renderInputView()}
+        <ErrorView errorMessage={errorMessage} errorSpacing={errorSpacing} />
       </View>
     );
-  };
-
-  return (
-    <View
-      style={styles.wrapper}
-      accessibilityLabel={`InputTextArea/${floatingValue}`}>
-      {renderInputView()}
-      <ErrorView errorMessage={errorMessage} />
-    </View>
-  );
-};
+  },
+);
 
 InputTextArea.defaultProps = {
   maxLength: MAX_LENGTH,

package/Input/common.tsx

@@ -5,6 +5,7 @@ import React, {FC, useContext} from 'react';
 import {ApplicationContext} from '../Application';
 import {Icon} from '../Icon';
 import {Styles} from '../Consts';
+import {Theme} from '../Application/types';
 
 type FloatingViewProps = {
   floatingValue?: string;
@@ -18,12 +19,11 @@ export const DEFAULT_HEIGHT = 112;
 export const MAX_LENGTH = 300;
 
 export const getBorderColor = (
+  theme: Theme,
   focused: boolean,
   errorMessage?: string,
   disabled?: boolean,
 ) => {
-  const {theme} = useContext(ApplicationContext);
-
   let borderColor = theme.colors.border.default;
 
   if (focused) {
@@ -47,7 +47,10 @@ export const getSizeStyle = (size?: 'small' | 'large') => {
   }
   return styles.container;
 };
-export const ErrorView: FC<{errorMessage?: string}> = ({errorMessage}) => {
+export const ErrorView: FC<{errorMessage?: string; errorSpacing?: boolean}> = ({
+  errorMessage,
+  errorSpacing,
+}) => {
   const {theme} = useContext(ApplicationContext);
   const errorColor = theme.colors.error.primary;
   if (errorMessage) {
@@ -59,14 +62,17 @@ export const ErrorView: FC<{errorMessage?: string}> = ({errorMessage}) => {
         <Text
           style={Styles.flex}
           color={errorColor}
-          numberOfLines={1}
+          numberOfLines={2}
           typography={'description_s'}>
           {errorMessage}
         </Text>
       </View>
     );
   }
-  return null;
+  if (errorSpacing) {
+    return <View style={[styles.errorView, {height: 18}]} />;
+  }
+  return <View />;
 };
 
 export const FloatingView: FC<FloatingViewProps> = ({

package/Input/index.tsx

@@ -52,6 +52,18 @@ export interface InputProps extends TextInputProps {
    * Defaults to `false` if not provided.
    */
   required?: boolean;
+
+  /**
+   * Optional. If `true`,
+   * include spacing when Input not have error message.
+   * Defaults to `false` if not provided.
+   */
+  errorSpacing?: boolean;
+
+  /**
+   *  If true, the icon of input will use be show indicator loading.
+   */
+  loading?: boolean;
 }
 
 type InputPropsWithoutSizeAndIcon = Omit<

package/Layout/Card.tsx

@@ -1,7 +1,7 @@
 import React, {useContext} from 'react';
-import {Dimensions, View} from 'react-native';
+import {Dimensions, View, ViewProps} from 'react-native';
 import {useGridSystem, validateChildren} from './utils';
-import {CardProps, GridContextProps} from './types';
+import {GridContextProps} from './types';
 import {GridContext, GridSystem} from './index';
 import Item from './Item';
 import {Image} from '../Image';
@@ -9,6 +9,13 @@ import {ApplicationContext} from '../Application';
 import styles from './styles';
 import {Colors, Spacing} from '../Consts';
 
+export interface CardProps extends ViewProps {
+  /**
+   * Optional. Background image for the card.
+   */
+  backgroundImage?: string;
+}
+
 const Card: React.FC<CardProps> = ({children, style, backgroundImage}) => {
   const {showGrid} = useContext(ApplicationContext);
   const {numberOfColumns} = useGridSystem();

package/Layout/GridSystem.tsx

@@ -51,7 +51,7 @@ const GridSystem: React.FC<any> = ({
             bottom: Spacing.M,
           },
         ]}>
-        {list.map((i, index) => {
+        {list.map((_, index) => {
           return (
             <View style={{flexDirection: 'row'}} key={index.toString()}>
               {index != -0 && <View style={{width: grid.gutterSize}} />}

package/Layout/Item.tsx

@@ -1,11 +1,24 @@
 import React, {useContext} from 'react';
-import {View} from 'react-native';
+import {View, ViewProps} from 'react-native';
 
-import {ItemProps} from './types';
 import {GridContext} from './index';
 import {ApplicationContext} from '../Application';
 import styles from './styles';
 
+type SpanNumber = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
+
+export interface ItemProps extends ViewProps {
+  /**
+   * Represents the width of the Card component in terms of span numbers (1-12).
+   */
+  widthSpan?: SpanNumber;
+
+  /**
+   * Optional. Represents the height of the Card component in terms of span numbers (1-12).
+   */
+  heightSpan?: SpanNumber;
+}
+
 const Item: React.FC<ItemProps> = ({
   widthSpan,
   heightSpan,

package/Layout/Screen.tsx

@@ -1,13 +1,70 @@
-import {Animated, KeyboardAvoidingView, Platform, View} from 'react-native';
+import {
+  Animated,
+  KeyboardAvoidingView,
+  Platform,
+  ScrollViewProps,
+  View,
+  ViewProps,
+} from 'react-native';
 import {useHeaderHeight} from '@react-navigation/stack';
 import {useSafeAreaInsets} from 'react-native-safe-area-context';
-import React, {useContext, useEffect, useRef} from 'react';
-import {ScreenProps} from '../Application/types';
+import React, {ReactNode, useContext, useEffect, useRef} from 'react';
 import {Spacing, Styles} from '../Consts';
 import {Card, Section, validateChildren} from './index';
-import {ApplicationContext} from '../Application';
+import {ApplicationContext, HeaderTitle} from '../Application';
 import Navigation from '../Application/Navigation';
-import {HeaderTitle} from '../Application/Components';
+
+export interface ScreenProps extends ViewProps {
+  /**
+   * Optional. Navigation object for handling navigation actions.
+   */
+  navigation?: Navigation;
+
+  /**
+   * Optional. If `true`, enable keyboard avoiding view for the screen.
+   */
+  enableKeyboardAvoidingView?: boolean;
+
+  /**
+   * Optional. Background color of the header.
+   */
+  headerBackground?: string;
+
+  /**
+   * Optional. If `true`, the screen content is scrollable.
+   */
+  scrollable?: boolean;
+
+  /**
+   * Optional. If `true`, use an animated header for the screen.
+   */
+  useAnimatedHeader?: boolean;
+
+  /**
+   * Optional. If `true`, use an extended header for the screen.
+   */
+  useExtendedHeader?: boolean;
+
+  /**
+   * Optional. Props for the underlying ScrollView component when `scrollable` is `true`.
+   */
+  scrollViewProps?: ScrollViewProps;
+
+  /**
+   * Optional. ReactNode representing the footer component of the screen.
+   */
+  footerComponent?: ReactNode;
+
+  /**
+   * Optional. Margin for the header component.
+   */
+  marginHeader?: number;
+
+  /**
+   * Optional. Background color of the screen.
+   */
+  backgroundColor?: string;
+}
 
 const Screen: React.FC<ScreenProps> = ({
   children,
@@ -70,7 +127,6 @@ const Screen: React.FC<ScreenProps> = ({
         const stackNavigation = new Navigation(current?.getParent(), theme);
         stackNavigation?.setOptions({
           animatedValue: animatedValue.current,
-          headerTransparent: true,
         });
       });
     }
@@ -130,8 +186,20 @@ const Screen: React.FC<ScreenProps> = ({
           </View>
         );
       });
+    } else {
+      const item: any = children;
+      const space = item?.props?.useMargin === false ? 0 : Spacing.M;
+      return (
+        <View
+          key={`ScreenItem`}
+          style={{
+            marginTop: space,
+            flex: item?.props?.expanded ? 1 : undefined,
+          }}>
+          {children}
+        </View>
+      );
     }
-    return results;
   };
 
   return (
@@ -176,7 +244,7 @@ const Screen: React.FC<ScreenProps> = ({
           <View
             style={{
               paddingTop: Spacing.S,
-              paddingBottom: insets.bottom + Spacing.S,
+              paddingBottom: Math.min(insets.bottom, 20) + Spacing.S,
               backgroundColor: theme.colors.background.surface,
             }}>
             <Section>{Footer}</Section>

package/Layout/Section.tsx

@@ -1,13 +1,37 @@
 import React, {useContext} from 'react';
-import {Dimensions, View} from 'react-native';
+import {Dimensions, View, ViewProps} from 'react-native';
 import {useGridSystem, validateChildren} from './utils';
-import {GridContextProps, SectionProps} from './types';
+import {GridContextProps} from './types';
 import {GridContext} from './index';
 import Item from './Item';
 import {ApplicationContext} from '../Application';
 import styles from './styles';
 import {Image} from '../Image';
 
+export interface SectionProps extends ViewProps {
+  /**
+   * Optional. If `true`, the Section component will be displayed in an expanded state.
+   * Defaults to `false` if not provided.
+   */
+  expanded?: boolean;
+
+  /**
+   * Optional. If `true`, margin will be applied to the Section component.
+   * Defaults to `false` if not provided.
+   */
+  useMargin?: boolean;
+
+  /**
+   * Optional. Background color for the Section component.
+   */
+  backgroundColor?: string;
+
+  /**
+   * Optional. Background image for the Section component.
+   */
+  backgroundImage?: string;
+}
+
 const Section: React.FC<SectionProps> = ({
   children,
   useMargin = true,
@@ -116,7 +140,16 @@ const Section: React.FC<SectionProps> = ({
   };
 
   return (
-    <GridContext.Provider value={gridContext}>
+    <GridContext.Provider
+      value={{
+        numberOfColumns,
+        gutterSize,
+        margin,
+        sizePerSpan,
+        getSizeSpan: span => {
+          return span * sizePerSpan + (span - 1) * gutterSize;
+        },
+      }}>
       <View
         accessibilityLabel={`Section`}
         style={{

package/Layout/index.ts

@@ -11,7 +11,7 @@ const GridContext = createContext<GridContextProps>({
   gutterSize: 12,
   margin: 12,
   sizePerSpan: 0,
-  getSizeSpan: span => 0,
+  getSizeSpan: () => 0,
 });
 
 export {GridContext, Card, Section, GridSystem, validateChildren, Item};

package/Layout/types.ts

@@ -1,7 +1,3 @@
-import {ViewProps} from 'react-native';
-
-type SpanNumber = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
-
 export type GridContextProps = {
   /**
    * Represents the number of columns in the grid.
@@ -28,36 +24,3 @@ export type GridContextProps = {
    */
   getSizeSpan: (span: number) => number;
 };
-export interface SectionProps extends ViewProps {
-  /**
-   * Optional. If `true`, the Section component will be displayed in an expanded state.
-   * Defaults to `false` if not provided.
-   */
-  expanded?: boolean;
-
-  /**
-   * Optional. If `true`, margin will be applied to the Section component.
-   * Defaults to `false` if not provided.
-   */
-  useMargin?: boolean;
-
-  backgroundColor?: string;
-
-  backgroundImage?: string;
-}
-
-export interface ItemProps extends ViewProps {
-  /**
-   * Represents the width of the Card component in terms of span numbers (1-12).
-   */
-  widthSpan?: SpanNumber;
-
-  /**
-   * Optional. Represents the height of the Card component in terms of span numbers (1-12).
-   */
-  heightSpan?: SpanNumber;
-}
-
-export interface CardProps extends ViewProps {
-  backgroundImage?: string;
-}

package/Layout/utils.ts

@@ -62,15 +62,12 @@ const useGridSystem = () => {
   );
 
   useEffect(() => {
-    const subscription: any = Dimensions.addEventListener(
-      'change',
-      ({window}: any) => {
-        const newColumns = Dimensions.get('window').width > 600 ? 24 : 12;
-        if (newColumns != numberOfColumns) {
-          setNumberOfColumns(newColumns);
-        }
-      },
-    );
+    const subscription: any = Dimensions.addEventListener('change', () => {
+      const newColumns = Dimensions.get('window').width > 600 ? 24 : 12;
+      if (newColumns != numberOfColumns) {
+        setNumberOfColumns(newColumns);
+      }
+    });
     return () => subscription?.remove();
   }, []);