@utilitywarehouse/hearth-react-native 0.2.0 → 0.3.0

package/build/components/Tabs/Tab.d.ts

@@ -0,0 +1,18 @@
+import type TabProps from './Tab.props';
+declare const PressableTab: import("react").ForwardRefExoticComponent<TabProps & {
+    states?: {
+        active?: boolean;
+        disabled?: boolean;
+    };
+} & Omit<import("react-native").PressableProps, "children"> & {
+    tabIndex?: 0 | -1 | undefined;
+} & {
+    children?: import("react").ReactNode | (({ hovered, pressed, focused, focusVisible, disabled, }: {
+        hovered?: boolean | undefined;
+        pressed?: boolean | undefined;
+        focused?: boolean | undefined;
+        focusVisible?: boolean | undefined;
+        disabled?: boolean | undefined;
+    }) => import("react").ReactNode);
+} & import("react").RefAttributes<unknown>>;
+export default PressableTab;

package/build/components/Tabs/Tab.js

@@ -0,0 +1,74 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useRef } from 'react';
+import { Platform, Pressable, View } from 'react-native';
+import { StyleSheet } from 'react-native-unistyles';
+import { DetailText } from '../DetailText';
+import { Icon } from '../Icon';
+import { useTabsContext } from './Tabs.context';
+import { createPressable } from '@gluestack-ui/pressable';
+const Tab = ({ value, children, icon, disabled, style, states, ...props }) => {
+    const { value: active, select, size, disabled: allDisabled, registerTabLayout, } = useTabsContext();
+    const { active: pressed } = states || { active: false };
+    const isActive = active === value;
+    styles.useVariants({ size, pressed });
+    const ref = useRef(null);
+    const handlePress = () => {
+        if (disabled || allDisabled)
+            return;
+        select(value);
+    };
+    const handleLayout = useCallback((e) => {
+        const { x, y, width, height } = e.nativeEvent.layout;
+        registerTabLayout(value, { x, y, width, height });
+    }, [value, registerTabLayout]);
+    return (_jsx(Pressable, { ref: ref, accessibilityRole: "tab", accessibilityState: { selected: isActive, disabled: !!(disabled || allDisabled) }, onPress: handlePress, onLayout: handleLayout, style: [styles.tab, style], ...(Platform.OS === 'web'
+            ? { id: `tab-${value}`, 'aria-controls': `tabpanel-${value}` }
+            : null), ...props, children: _jsxs(View, { style: styles.content, children: [icon ? _jsx(Icon, { as: icon }) : null, _jsx(DetailText, { size: size, children: children })] }) }));
+};
+Tab.displayName = 'Tab';
+const styles = StyleSheet.create(theme => ({
+    tab: {
+        position: 'relative',
+        backgroundColor: 'transparent',
+        alignItems: 'center',
+        justifyContent: 'center',
+        paddingHorizontal: theme.components.tabs.item.paddingHorizontal,
+        paddingVertical: theme.components.tabs.item.paddingVertical,
+        _web: {
+            _hover: {
+                backgroundColor: theme.color.interactive.neutral.surface.subtle.hover,
+            },
+            '_focus-visible': {
+                ...theme.helpers.focusVisible,
+                outlineOffset: -2,
+                borderRadius: theme.borderRadius.sm,
+            },
+            _active: {
+                backgroundColor: theme.color.interactive.neutral.surface.subtle.active,
+            },
+        },
+        variants: {
+            size: {
+                md: { height: theme.components.tabs.md.height },
+                lg: { height: theme.components.tabs.lg.height },
+            },
+            pressed: {
+                true: {
+                    backgroundColor: theme.color.interactive.neutral.surface.subtle.active,
+                },
+                false: {},
+            },
+        },
+    },
+    content: {
+        flexDirection: 'row',
+        alignItems: 'center',
+        gap: theme.components.tabs.item.gap,
+    },
+    badge: {
+        marginLeft: theme.space[25],
+    },
+}));
+const PressableTab = createPressable({ Root: Tab });
+PressableTab.displayName = 'Tab';
+export default PressableTab;

package/build/components/Tabs/Tab.props.d.ts

@@ -0,0 +1,14 @@
+import type { ComponentType, ReactNode } from 'react';
+import type { PressableProps, ViewProps } from 'react-native';
+export interface TabProps extends PressableProps {
+    /** Unique value for the tab */
+    value: string;
+    /** Tab label */
+    children: ReactNode;
+    /** Optional leading icon */
+    icon?: ComponentType<any>;
+    /** Whether the tab is disabled */
+    disabled?: boolean;
+    style?: ViewProps['style'];
+}
+export default TabProps;

package/build/components/Tabs/Tab.props.js

@@ -0,0 +1 @@
+export {};

package/build/components/Tabs/TabPanel.d.ts

@@ -0,0 +1,3 @@
+import type TabPanelProps from './TabPanel.props';
+declare const _default: import("react").MemoExoticComponent<({ value, children, keepMounted, style, ...rest }: TabPanelProps) => import("react/jsx-runtime").JSX.Element | null>;
+export default _default;

package/build/components/Tabs/TabPanel.js

@@ -0,0 +1,34 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { memo } from 'react';
+import { Platform, View } from 'react-native';
+import { StyleSheet } from 'react-native-unistyles';
+import { useTabsContext } from './Tabs.context';
+const TabPanel = ({ value, children, keepMounted, style, ...rest }) => {
+    const { value: active } = useTabsContext();
+    const isActive = active === value;
+    if (!isActive && !keepMounted)
+        return null;
+    styles.useVariants({ active: isActive });
+    return (_jsx(View, { ...(Platform.OS === 'web'
+            ? {
+                id: `tabpanel-${value}`,
+                role: 'tabpanel',
+                'aria-labelledby': `tab-${value}`,
+                hidden: !isActive || undefined,
+            }
+            : { accessibilityRole: 'summary' }), importantForAccessibility: isActive ? undefined : 'no-hide-descendants', accessibilityElementsHidden: isActive ? undefined : true, style: [styles.panel, style], ...rest, children: children }));
+};
+const styles = StyleSheet.create(theme => ({
+    panel: {
+        flex: 1,
+        width: '100%',
+        paddingTop: theme.space[100],
+        variants: {
+            active: {
+                true: { display: 'flex' },
+                false: { display: 'none' },
+            },
+        },
+    },
+}));
+export default memo(TabPanel);

package/build/components/Tabs/TabPanel.props.d.ts

@@ -0,0 +1,8 @@
+import type { ReactNode } from 'react';
+import type { ViewProps } from 'react-native';
+export interface TabPanelProps extends ViewProps {
+    value: string;
+    children: ReactNode;
+    keepMounted?: boolean;
+}
+export default TabPanelProps;

package/build/components/Tabs/TabPanel.props.js

@@ -0,0 +1 @@
+export {};

package/build/components/Tabs/Tabs.context.d.ts

@@ -0,0 +1,23 @@
+import { SharedValue } from 'react-native-reanimated';
+export interface TabsContextValue {
+    value: string | undefined;
+    size: 'md' | 'lg';
+    disabled?: boolean;
+    select: (value: string) => void;
+    registerTabLayout: (value: string, layout: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }) => void;
+    getTabLayout: (value: string) => {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | undefined;
+    indicatorXSV: SharedValue<number>;
+    indicatorSizeSV: SharedValue<number>;
+}
+export declare const TabsContext: import("react").Context<TabsContextValue | undefined>;
+export declare const useTabsContext: () => TabsContextValue;

package/build/components/Tabs/Tabs.context.js

@@ -0,0 +1,8 @@
+import { createContext, useContext } from 'react';
+export const TabsContext = createContext(undefined);
+export const useTabsContext = () => {
+    const ctx = useContext(TabsContext);
+    if (!ctx)
+        throw new Error('Tab / TabPanel must be used within Tabs');
+    return ctx;
+};

package/build/components/Tabs/Tabs.d.ts

@@ -0,0 +1,6 @@
+import type TabsProps from './Tabs.props';
+declare const Tabs: {
+    ({ value: controlledValue, defaultValue, onValueChange, size, disabled, children, withPanels, ...props }: TabsProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export default Tabs;

package/build/components/Tabs/Tabs.js

@@ -0,0 +1,114 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Children, isValidElement, useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { View } from 'react-native';
+import { Easing, useSharedValue, withTiming } from 'react-native-reanimated';
+import { TabsContext } from './Tabs.context';
+const Tabs = ({ value: controlledValue, defaultValue, onValueChange, size = 'md', disabled, children, withPanels, ...props }) => {
+    // Collect child tab values
+    const tabValues = useMemo(() => {
+        const vals = [];
+        const walk = (node) => {
+            Children.forEach(node, child => {
+                if (!isValidElement(child))
+                    return;
+                const props = child.props;
+                const type = child.type;
+                if (type?.displayName === 'Tab' && typeof props?.value === 'string') {
+                    vals.push(props.value);
+                }
+                if (props?.children)
+                    walk(props.children);
+            });
+        };
+        walk(children);
+        return vals;
+    }, [children]);
+    const getInitial = () => {
+        if (controlledValue !== undefined)
+            return controlledValue;
+        if (defaultValue)
+            return defaultValue;
+        return tabValues[0];
+    };
+    const [uncontrolled, setUncontrolled] = useState(getInitial);
+    useEffect(() => {
+        if (controlledValue !== undefined)
+            setUncontrolled(controlledValue);
+    }, [controlledValue]);
+    // Ensure value remains valid if tabs change
+    useEffect(() => {
+        setUncontrolled(prev => {
+            if (!prev)
+                return tabValues[0];
+            if (!tabValues.includes(prev))
+                return tabValues[0];
+            return prev;
+        });
+    }, [tabValues.join('|')]);
+    const currentValue = controlledValue !== undefined ? controlledValue : uncontrolled;
+    const select = useCallback((val) => {
+        if (disabled)
+            return;
+        if (controlledValue === undefined)
+            setUncontrolled(val);
+        onValueChange?.(val);
+    }, [controlledValue, disabled, onValueChange]);
+    // Indicator shared values (declared early so registerTabLayout can reference)
+    const indicatorX = useSharedValue(0);
+    const indicatorSize = useSharedValue(0);
+    // Layout registry for animated indicator
+    const layoutsRef = useRef(new Map());
+    const prevValueRef = useRef(undefined);
+    const initialisedRef = useRef(false);
+    const registerTabLayout = useCallback((value, layout) => {
+        layoutsRef.current.set(value, layout);
+        const active = controlledValue !== undefined ? controlledValue : uncontrolled;
+        if (!active)
+            return;
+        // Initial active tab: seed indicator & prevValue so first change animates
+        if (!initialisedRef.current && value === active) {
+            indicatorX.value = layout.x;
+            indicatorSize.value = layout.width;
+            prevValueRef.current = active;
+            initialisedRef.current = true;
+        }
+    }, [controlledValue, uncontrolled, indicatorX, indicatorSize]);
+    const getTabLayout = useCallback((v) => layoutsRef.current.get(v), []);
+    const contextValue = useMemo(() => ({
+        value: currentValue,
+        size,
+        select,
+        disabled,
+        registerTabLayout,
+        getTabLayout,
+        indicatorXSV: indicatorX,
+        indicatorSizeSV: indicatorSize,
+    }), [
+        currentValue,
+        size,
+        select,
+        disabled,
+        registerTabLayout,
+        getTabLayout,
+        tabValues,
+        indicatorX,
+        indicatorSize,
+    ]);
+    // Animate indicator only on value changes after initialisation
+    useEffect(() => {
+        if (!currentValue || !initialisedRef.current)
+            return;
+        if (prevValueRef.current === undefined || prevValueRef.current === currentValue)
+            return;
+        const layout = getTabLayout(currentValue);
+        if (!layout)
+            return;
+        const cfg = { duration: 250, easing: Easing.out(Easing.ease) };
+        indicatorX.value = withTiming(layout.x, cfg);
+        indicatorSize.value = withTiming(layout.width, cfg);
+        prevValueRef.current = currentValue;
+    }, [currentValue, getTabLayout, indicatorX, indicatorSize, tabValues.join('|')]);
+    return (_jsx(TabsContext.Provider, { value: contextValue, children: _jsx(View, { ...props, children: children }) }));
+};
+Tabs.displayName = 'Tabs';
+export default Tabs;

package/build/components/Tabs/Tabs.props.d.ts

@@ -0,0 +1,19 @@
+import type { ReactNode } from 'react';
+import type { ViewProps } from 'react-native';
+export interface TabsProps extends ViewProps {
+    /** Controlled active tab value */
+    value?: string;
+    /** Uncontrolled initial value */
+    defaultValue?: string;
+    /** Callback when active tab changes */
+    onValueChange?: (value: string) => void;
+    /** Size variant */
+    size?: 'md' | 'lg';
+    /** Tabs (Tab components) */
+    children: ReactNode;
+    /** Disable all tabs */
+    disabled?: boolean;
+    /** If true, expect sibling TabPanel components and manage their rendering/ARIA linkage */
+    withPanels?: boolean;
+}
+export default TabsProps;

package/build/components/Tabs/Tabs.props.js

@@ -0,0 +1 @@
+export {};

package/build/components/Tabs/TabsList.d.ts

@@ -0,0 +1,6 @@
+import type TabsListProps from './TabsList.props';
+declare const TabsList: {
+    ({ children, style, ...rest }: TabsListProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export default TabsList;

package/build/components/Tabs/TabsList.js

@@ -0,0 +1,112 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ChevronLeftSmallIcon, ChevronRightSmallIcon, } from '@utilitywarehouse/hearth-react-native-icons';
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { Platform, View } from 'react-native';
+import Animated, { runOnJS, useAnimatedScrollHandler, useAnimatedStyle, useSharedValue, } from 'react-native-reanimated';
+import { StyleSheet } from 'react-native-unistyles';
+import { UnstyledIconButton } from '../UnstyledIconButton';
+import { useTabsContext } from './Tabs.context';
+const Indicator = Animated.createAnimatedComponent(View);
+const SCROLL_STEP_RATIO = 0.6;
+const SCROLL_BUTTON_HITSLOP = { top: 10, bottom: 10, left: 10, right: 10 };
+const TabsList = ({ children, style, ...rest }) => {
+    const { indicatorSizeSV, indicatorXSV } = useTabsContext();
+    const scrollRef = useRef(null);
+    const [canScrollLeft, setCanScrollLeft] = useState(false);
+    const [canScrollRight, setCanScrollRight] = useState(false);
+    const containerWidthRef = useRef(0);
+    const contentWidthRef = useRef(0);
+    const scrollX = useSharedValue(0);
+    const indicatorStyle = useAnimatedStyle(() => ({
+        transform: [{ translateX: indicatorXSV.value }],
+        width: indicatorSizeSV.value,
+    }));
+    const updateScrollState = useCallback(() => {
+        const cw = containerWidthRef.current;
+        const contentW = contentWidthRef.current;
+        const x = scrollX.value;
+        const overflow = contentW > cw + 1;
+        setCanScrollLeft(overflow && x > 0);
+        setCanScrollRight(overflow && x + cw < contentW - 1);
+    }, [scrollX]);
+    const onLayoutContainer = (e) => {
+        containerWidthRef.current = e.nativeEvent.layout.width;
+        updateScrollState();
+    };
+    const onContentSizeChange = (w) => {
+        contentWidthRef.current = w;
+        updateScrollState();
+    };
+    const onScrollHandler = useAnimatedScrollHandler({
+        onScroll: (e) => {
+            scrollX.value = e.contentOffset.x;
+            runOnJS(updateScrollState)();
+        },
+    });
+    const scrollBy = (direction) => {
+        const viewW = containerWidthRef.current;
+        const step = viewW * SCROLL_STEP_RATIO;
+        const current = scrollX.value;
+        const max = Math.max(0, contentWidthRef.current - viewW);
+        const target = Math.max(0, Math.min(current + direction * step, max));
+        scrollRef.current?.scrollTo({ x: target, animated: true });
+    };
+    useEffect(() => {
+        if (Platform.OS === 'web') {
+            const handler = () => updateScrollState();
+            window.addEventListener('resize', handler);
+            return () => window.removeEventListener('resize', handler);
+        }
+        return;
+    }, [updateScrollState]);
+    return (_jsxs(View, { style: [styles.wrapper, style], ...rest, accessibilityRole: "tablist", children: [canScrollLeft && (_jsx(View, { style: [styles.iconButtonWrap, styles.scrollButtonLeft], accessibilityElementsHidden: true, importantForAccessibility: "no-hide-descendants", ...(Platform.OS === 'web' ? { 'aria-hidden': true } : {}), children: _jsx(UnstyledIconButton, { accessibilityLabel: undefined, icon: ChevronLeftSmallIcon, onPress: () => scrollBy(-1), style: styles.iconButton, accessibilityElementsHidden: true, importantForAccessibility: "no-hide-descendants", hitSlop: SCROLL_BUTTON_HITSLOP, ...(Platform.OS === 'web' ? { 'aria-hidden': true, tabIndex: -1 } : {}) }) })), _jsx(Animated.ScrollView, { ref: scrollRef, horizontal: true, showsHorizontalScrollIndicator: false, onLayout: onLayoutContainer, onContentSizeChange: onContentSizeChange, onScroll: onScrollHandler, scrollEventThrottle: 16, bounces: false, contentContainerStyle: styles.scrollContent, children: _jsxs(View, { style: styles.container, children: [children, _jsx(Indicator, { accessibilityElementsHidden: true, importantForAccessibility: "no-hide-descendants", style: [styles.indicator, indicatorStyle] })] }) }), canScrollRight && (_jsx(View, { style: [styles.iconButtonWrap, styles.scrollButtonRight], accessibilityElementsHidden: true, importantForAccessibility: "no-hide-descendants", ...(Platform.OS === 'web' ? { 'aria-hidden': true } : {}), children: _jsx(UnstyledIconButton, { accessibilityLabel: undefined, icon: ChevronRightSmallIcon, onPress: () => scrollBy(1), style: styles.iconButton, accessibilityElementsHidden: true, importantForAccessibility: "no-hide-descendants", hitSlop: SCROLL_BUTTON_HITSLOP, ...(Platform.OS === 'web' ? { 'aria-hidden': true, tabIndex: -1 } : {}) }) }))] }));
+};
+TabsList.displayName = 'TabsList';
+const styles = StyleSheet.create(theme => ({
+    wrapper: {
+        position: 'relative',
+        width: '100%',
+        borderBottomWidth: theme.components.tabs.divider.borderWidth,
+        borderColor: theme.components.tabs.divider.color,
+    },
+    scrollContent: {
+        paddingBottom: 0,
+    },
+    container: {
+        position: 'relative',
+        flexDirection: 'row',
+        gap: theme.components.tabs.gap,
+    },
+    indicator: {
+        position: 'absolute',
+        height: 6,
+        borderTopLeftRadius: theme.components.tabs.item.selected.borderTopRadius,
+        borderTopRightRadius: theme.components.tabs.item.selected.borderTopRadius,
+        borderBottomLeftRadius: theme.components.tabs.item.selected.borderBottomRadius,
+        borderBottomRightRadius: theme.components.tabs.item.selected.borderBottomRadius,
+        backgroundColor: theme.color.surface.brand.default,
+        bottom: 0,
+        left: 0,
+    },
+    scrollButtonLeft: {
+        position: 'absolute',
+        left: 0,
+        top: '50%',
+        transform: [{ translateY: -theme.space[150] }],
+        zIndex: 10,
+    },
+    scrollButtonRight: {
+        position: 'absolute',
+        right: 0,
+        top: '50%',
+        transform: [{ translateY: -theme.space[150] }],
+        zIndex: 10,
+    },
+    iconButtonWrap: {},
+    iconButton: {
+        backgroundColor: theme.color.surface.neutral.subtle,
+        width: theme.space[300],
+        height: theme.space[300],
+    },
+}));
+export default TabsList;

package/build/components/Tabs/TabsList.props.d.ts

@@ -0,0 +1,6 @@
+import type { ReactNode } from 'react';
+import type { ViewProps } from 'react-native';
+export interface TabsListProps extends ViewProps {
+    children: ReactNode;
+}
+export default TabsListProps;

package/build/components/Tabs/TabsList.props.js

@@ -0,0 +1 @@
+export {};

package/build/components/Tabs/index.d.ts

@@ -0,0 +1,8 @@
+export { default as Tab } from './Tab';
+export type { TabProps } from './Tab.props';
+export { default as TabPanel } from './TabPanel';
+export type { TabPanelProps } from './TabPanel.props';
+export { default as Tabs } from './Tabs';
+export type { TabsProps } from './Tabs.props';
+export { default as TabsList } from './TabsList';
+export type { TabsListProps } from './TabsList.props';

package/build/components/Tabs/index.js

@@ -0,0 +1,4 @@
+export { default as Tab } from './Tab';
+export { default as TabPanel } from './TabPanel';
+export { default as Tabs } from './Tabs';
+export { default as TabsList } from './TabsList';

package/build/components/index.d.ts

@@ -8,6 +8,8 @@ export * from './Button';
 export * from './Card';
 export * from './Center';
 export * from './Checkbox';
+export * from './CurrencyInput';
+export * from './DescriptionList';
 export * from './DetailText';
 export * from './Divider';
 export * from './Flex';
@@ -18,6 +20,7 @@ export * from './Helper';
 export * from './HTMLElements';
 export * from './Icon';
 export * from './IconButton';
+export * from './IconContainer';
 export * from './InlineLink';
 export * from './Input';
 export * from './Label';
@@ -31,6 +34,7 @@ export * from './Select';
 export * from './Skeleton';
 export * from './Spinner';
 export * from './Switch';
+export * from './Tabs';
 export * from './Textarea';
 export * from './ToggleButtonCard';
 export { FlatList, Image, KeyboardAvoidingView, ScrollView, SectionList, StatusBar, View, } from 'react-native';

package/build/components/index.js

@@ -9,6 +9,8 @@ export * from './Button';
 export * from './Card';
 export * from './Center';
 export * from './Checkbox';
+export * from './CurrencyInput';
+export * from './DescriptionList';
 export * from './DetailText';
 export * from './Divider';
 export * from './Flex';
@@ -19,6 +21,7 @@ export * from './Helper';
 export * from './HTMLElements';
 export * from './Icon';
 export * from './IconButton';
+export * from './IconContainer';
 export * from './InlineLink';
 export * from './Input';
 export * from './Label';
@@ -32,6 +35,7 @@ export * from './Select';
 export * from './Skeleton';
 export * from './Spinner';
 export * from './Switch';
+export * from './Tabs';
 export * from './Textarea';
 export * from './ToggleButtonCard';
 export { FlatList, Image, KeyboardAvoidingView, ScrollView, SectionList, StatusBar, View, } from 'react-native';