react-native-ui-lib 8.3.4-snapshot.7813 → 8.3.4-snapshot.7824

package/src/components/timeline/index.js

@@ -21,7 +21,7 @@ const Timeline = props => {
   const [anchorMeasurements, setAnchorMeasurements] = useState();
   const [contentContainerMeasurements, setContentContainerMeasurements] = useState();
   const [pointMeasurements, setPointMeasurements] = useState();
-  const contentContainerRef = useRef(undefined);
+  const contentContainerRef = useRef();
   const onMeasure = (x, y, width, height) => {
     setAnchorMeasurements({
       x,

package/src/components/toast/index.js

@@ -1,4 +1,5 @@
 import _ from 'lodash';
+import PropTypes from 'prop-types';
 import React from 'react';
 import {AccessibilityInfo, findNodeHandle, StyleSheet, Animated, Easing, ActivityIndicator} from 'react-native';
 import {PureBaseComponent} from '../../commons';
@@ -20,6 +21,74 @@ const COLOR = Colors.white;
 export default class Toast extends PureBaseComponent {
   static displayName = 'Toast';
 
+  static propTypes = {
+    /**
+     * Whether to show or hide the toast
+     */
+    visible: PropTypes.bool,
+    /**
+     * The position of the toast. 'top' or 'bottom'.
+     */
+    position: PropTypes.oneOf(['top', 'bottom']),
+    /**
+     * custom zIndex for toast
+     */
+    zIndex: PropTypes.number,
+    /**
+     * The background color of the toast
+     */
+    backgroundColor: PropTypes.string,
+    /**
+     * the toast content color (message, actions labels)
+     */
+    color: PropTypes.string,
+    /**
+     * the toast message
+     */
+    message: PropTypes.string,
+    /**
+     * should message be centered in the toast
+     */
+    centerMessage: PropTypes.bool,
+    /**
+     * a left icon
+     */
+    icon: PropTypes.oneOfType([PropTypes.object, PropTypes.number]),
+    /**
+     * a single action for the user
+     */
+    action: PropTypes.shape(Button.propTypes),
+    /**
+     * should show a loader (showDismiss must be false)
+     */
+    showLoader: PropTypes.bool,
+    /**
+     * callback for dismiss action
+     */
+    onDismiss: PropTypes.func,
+    /**
+     * number of milliseconds to automatically invoke the onDismiss callback
+     */
+    autoDismiss: PropTypes.number,
+    /**
+     * show dismiss action (right 'X' button)
+     */
+    showDismiss: PropTypes.bool,
+    /**
+     * callback for end of component animation
+     */
+    onAnimationEnd: PropTypes.func,
+    /**
+     * render a custom view that will appear permanently above or below a Toast,
+     * depends on the Toast's position, and animate with it when the Toast is made visible or dismissed
+     */
+    renderAttachment: PropTypes.elementType,
+    /**
+     * render a custom loader component instead of the default when passing showLoader
+     */
+    customLoader: PropTypes.func
+  };
+
   static defaultProps = {
     position: 'top',
     zIndex: 100

package/src/components/wizard/index.d.ts

@@ -24,7 +24,7 @@ declare class Wizard extends Component<WizardProps, State> {
     componentWillUnmount(): void;
     onOrientationChange: () => void;
     getMaxWidth(): number;
-    renderChildren(): React.DetailedReactHTMLElement<React.HTMLAttributes<HTMLElement>, HTMLElement>[] | null | undefined;
+    renderChildren(): React.DetailedReactHTMLElement<any, HTMLElement>[] | null | undefined;
     render(): React.JSX.Element;
 }
 declare const _default: React.ForwardRefExoticComponent<WizardProps & React.RefAttributes<any>> & typeof Wizard;

package/src/components/wizard/types.d.ts

@@ -73,7 +73,7 @@ export interface WizardProps {
      */
     activeIndex: number;
     /**
-     * The configuration of the active step
+     * The configuration of the active step (see Wizard.Step.propTypes)
      */
     activeConfig?: WizardStepProps;
     /**

package/src/components/wizard/wizard.api.json

@@ -17,7 +17,7 @@
     {
       "name": "activeConfig",
       "type": "WizardStepProps",
-      "description": "The configuration of the active step"
+      "description": "The configuration of the active step (see Wizard.Step.propTypes)"
     },
     {
       "name": "onActiveIndexChanged",

package/src/helpers/DocsGenerator.js

@@ -0,0 +1,61 @@
+import React from 'react';
+import _ from 'lodash';
+
+const TAB = '    ';
+const LINE_BREAK = '\n';
+
+export function extractComponentInfo(instance) {
+  const componentName = instance.constructor.displayName;
+  const defaultProps = instance.constructor.defaultProps || {};
+  const props = instance.props || {};
+  return {componentName, defaultProps, props};
+}
+
+export function generateSnippet({componentName, defaultProps, props}) {
+  let snippet = `<${componentName}`;
+
+  _.forEach(props, (value, key) => {
+    if (key === 'children') {
+      return;
+    }
+    let formattedValue = `{${value}}`;
+    if (_.isObject(value)) {
+      formattedValue = `{${JSON.stringify(value)}}`;
+    } else if (_.isString(value)) {
+      formattedValue = `"${value}"`;
+    } else if (_.isBoolean(value) && value === true) {
+      formattedValue = '';
+    }
+
+    const hasEmptyValue = _.isUndefined(value) || (_.isObject(value) && _.isEmpty(value));
+    const hasDefaultValue = value == defaultProps[key]; // eslint-disable-line
+    if (!hasEmptyValue && !hasDefaultValue) {
+      snippet += `${LINE_BREAK}${TAB}${key}`;
+      if (formattedValue) {
+        snippet += `=${formattedValue}`;
+      }
+    }
+  });
+
+  if (props.children) {
+    const childrenSnippets = React.Children.map(props.children, child => {
+      if (_.get(child, 'type.displayName')) {
+        const childSnippet =
+          TAB +
+          generateSnippet({
+            componentName: child.type.displayName,
+            props: child.props || {},
+            defaultProps: child.type.defaultProps || {}
+          });
+        return childSnippet;
+      }
+      if (typeof child === 'string') {
+        return child;
+      }
+    });
+    snippet += `>${LINE_BREAK}${childrenSnippets.join(LINE_BREAK)}${LINE_BREAK}</${componentName}>`;
+  } else {
+    snippet += '/>';
+  }
+  return snippet;
+}

package/src/hooks/useCombinedRefs/index.js

@@ -1,6 +1,6 @@
 import React from 'react';
 const useCombinedRefs = (...refs) => {
-  const targetRef = React.useRef(undefined);
+  const targetRef = React.useRef();
   React.useEffect(() => {
     refs.forEach(ref => {
       if (!ref) {
@@ -9,6 +9,7 @@ const useCombinedRefs = (...refs) => {
       if (typeof ref === 'function') {
         ref(targetRef.current);
       } else {
+        // @ts-expect-error
         ref.current = targetRef.current;
       }
     });

package/src/hooks/useDebounce/index.js

@@ -4,7 +4,7 @@ import { useCallback, useRef } from 'react';
  * This hook is used to debounce a function call
  */
 function useDebounce(func, timeout = 300) {
-  const handler = useRef(undefined);
+  const handler = useRef();
   const debouncedFunction = useCallback(args => {
     if (handler.current) {
       clearTimeout(handler.current);

package/src/hooks/useHiddenLocation/index.js

@@ -20,8 +20,8 @@ export default function useHiddenLocation() {
     };
   };
   const [hiddenLocation, setHiddenLocation] = useState(getHiddenLocation({}));
-  const ref = useRef(undefined);
-  const layoutData = useRef(undefined);
+  const ref = useRef();
+  const layoutData = useRef();
   const wasMeasured = useRef(wasMeasuredDefaultValue);
   const measure = useCallback(() => {
     if (ref.current && layoutData.current && layoutData.current.width > 0 && layoutData.current.height > 0) {

package/src/hooks/useHiddenLocation/index.web.js

@@ -16,8 +16,8 @@ export default function useHiddenLocation() {
     };
   };
   const [hiddenLocation, setHiddenLocation] = useState(getHiddenLocation({}));
-  const ref = useRef(undefined);
-  const layoutData = useRef(undefined);
+  const ref = useRef();
+  const layoutData = useRef();
   const wasMeasured = useRef(wasMeasuredDefaultValue);
   const measure = useCallback(() => {
     if (ref.current) {

package/src/hooks/useMeasure/index.d.ts

@@ -9,7 +9,7 @@ interface Measurements {
     pageY: number;
 }
 declare const _default: () => {
-    ref: import("react").RefObject<RNView | undefined>;
+    ref: import("react").MutableRefObject<RNView | undefined>;
     measurements: Measurements | undefined;
 };
 export default _default;

package/src/hooks/useMeasure/index.js

@@ -1,6 +1,6 @@
 import { useEffect, useRef, useState } from 'react';
 export default () => {
-  const ref = useRef(undefined);
+  const ref = useRef();
   const [measurements, setMeasurements] = useState();
   const onMeasure = (x, y, width, height, pageX, pageY) => {
     setMeasurements({

package/src/hooks/useScrollTo/index.d.ts

@@ -5,7 +5,7 @@ export type ScrollToProps<T extends ScrollToSupportedViews> = {
     /**
      * A reference to the ScrollView (or FlatList) which the items are in
      */
-    scrollViewRef?: RefObject<T | null>;
+    scrollViewRef?: RefObject<T>;
     /**
      * Is the scroll view horizontal (default is true)
      */
@@ -15,7 +15,7 @@ export type ScrollToResultProps<T extends ScrollToSupportedViews> = {
     /**
      * A reference to the ScrollView (or FlatList) which the items are in (from the props or a created one)
      */
-    scrollViewRef: RefObject<T | null>;
+    scrollViewRef: RefObject<T>;
     /**
      * scrollTo callback.
      * offset - the x or y to scroll to.

package/src/incubator/calendar/index.js

@@ -42,7 +42,7 @@ function Calendar(props) {
     }
     return -1;
   }, [monthItems]);
-  const flashListRef = useRef(undefined);
+  const flashListRef = useRef();
   const current = useSharedValue(new Date(initialDate).setHours(0, 0, 0, 0));
   const initialMonthIndex = useRef(getItemIndex(current.value));
   const lastUpdateSource = useSharedValue(UpdateSource.INIT);

package/src/incubator/calendar/types.d.ts

@@ -111,8 +111,8 @@ export interface CalendarProps {
     showExtraDays?: boolean;
 }
 export interface AgendaProps {
-    renderEvent?: (event: Event) => React.ReactElement<any> | null;
-    renderHeader?: (header: DateSectionHeader) => React.ReactElement<any> | null;
+    renderEvent?: (event: Event) => React.ReactElement | null;
+    renderHeader?: (header: DateSectionHeader) => React.ReactElement | null;
     showLoader?: boolean;
     onEndReached?: (date: number) => void;
 }

package/src/incubator/expandableOverlay/index.d.ts

@@ -14,7 +14,7 @@ export type ExpandableOverlayProps = TouchableOpacityProps & PropsWithChildren<{
     /**
      * The content to render inside the expandable modal/dialog
      */
-    expandableContent?: React.ReactElement<any>;
+    expandableContent?: React.ReactElement;
     /**
      * Whether to use a dialog as expandable container (by default the container will be a full screen modal)
      */
@@ -38,7 +38,7 @@ export type ExpandableOverlayProps = TouchableOpacityProps & PropsWithChildren<{
     /**
      * A custom overlay to render instead of Modal or Dialog components
      */
-    renderCustomOverlay?: (props: RenderCustomOverlayProps) => React.ReactElement<any> | undefined | null;
+    renderCustomOverlay?: (props: RenderCustomOverlayProps) => React.ReactElement | undefined | null;
     /**
      * Disabled opening expandable overlay
      */

package/src/incubator/slider/Track.d.ts

@@ -6,7 +6,7 @@ export interface Props extends ViewProps {
     maximumTrackTintColor?: string;
     minimumTrackTintColor?: string;
     trackStyle?: StyleProp<ViewStyle>;
-    renderTrack?: () => ReactElement<any> | ReactElement<any>[];
+    renderTrack?: () => ReactElement | ReactElement[];
     onPress?: ((event: GestureResponderEvent) => void) | undefined;
 }
 declare const Track: (props: Props) => React.JSX.Element;

package/src/incubator/slider/index.d.ts

@@ -62,7 +62,7 @@ export interface SliderProps extends AccessibilityProps {
     /**
      * Custom render instead of rendering the track
      */
-    renderTrack?: () => ReactElement<any> | ReactElement<any>[];
+    renderTrack?: () => ReactElement | ReactElement[];
     /**
      * The thumb style
      */

package/src/incubator/toast/helpers/useToastTimer.js

@@ -3,7 +3,7 @@ export default ({
   autoDismiss,
   onDismiss
 }) => {
-  const timer = useRef(undefined);
+  const timer = useRef();
   const clearTimer = useCallback(() => {
     if (timer.current) {
       clearTimeout(timer.current);

package/src/incubator/toast/index.js

@@ -43,7 +43,7 @@ const Toast = props => {
     testID
   } = props;
   const directions = useRef([props.position === 'bottom' ? PanView.directions.DOWN : PanView.directions.UP, PanView.directions.LEFT, PanView.directions.RIGHT]);
-  const viewRef = useRef(undefined);
+  const viewRef = useRef();
   const [toastHeight, setToastHeight] = useState();
   const {
     clearTimer,

package/src/incubator/toast/types.d.ts

@@ -1,4 +1,4 @@
-import { ReactElement, ReactNode, type JSX } from 'react';
+import { ReactElement, ReactNode } from 'react';
 import { ImageSourcePropType, StyleProp, TextStyle, ViewStyle } from 'react-native';
 import { ButtonProps } from '../../components/button';
 import { TextProps } from '../../components/text';
@@ -52,7 +52,7 @@ export interface ToastProps {
     /**
      * should show a loader
      */
-    loaderElement?: ReactElement<any>;
+    loaderElement?: ReactElement;
     /**
      * callback for dismiss action
      */

package/src/testkit/Component.driver.d.ts

@@ -1,4 +1,4 @@
-import type { JSX } from 'react';
+/// <reference types="react" />
 import { DragData, UniDriver, UniDriverClass } from './UniDriver';
 export type ComponentDriverArgs = {
     testID: string;

package/src/testkit/drivers/TestingLibraryDriver.d.ts

@@ -1,4 +1,4 @@
-import type { JSX } from 'react';
+/// <reference types="react" />
 import { DragData, UniDriver } from '../UniDriver';
 import { ReactTestInstance } from 'react-test-renderer';
 export declare class TestingLibraryDriver<Props> implements UniDriver<Props> {

package/src/typings/module.d.ts

@@ -3,20 +3,11 @@ declare namespace globalThis {
   var _UILIB_TESTING: boolean;
 }
 
-declare global {
-  // eslint-disable-next-line no-var
-  var _UILIB_TESTING: boolean;
-}
-
 // This support importing png files, typing wise
 declare module '*.png';
 
-import 'react';
-
-declare module 'react' {
-  namespace JSX {
-    interface IntrinsicAttributes {
-      fsTagName?: string;
-    }
+declare namespace JSX {
+  interface IntrinsicAttributes {
+    fsTagName?: string;
   }
 }

package/textFieldOld.d.ts

@@ -0,0 +1,2 @@
+import {TextFieldOld} from './src';
+export default TextFieldOld;

package/textFieldOld.js

@@ -0,0 +1 @@
+module.exports = require('./src/components/textFieldOld').default;