@webority-technologies/mobile 0.0.6 → 0.0.8

package/lib/module/theme/tokens.js

@@ -50,6 +50,260 @@ const radius = {
   '2xl': 28,
   full: 9999
 };
+const components = {
+  button: {
+    xs: {
+      paddingHorizontal: 10,
+      paddingVertical: 4,
+      minHeight: 28,
+      fontSize: 12,
+      borderRadius: 8
+    },
+    sm: {
+      paddingHorizontal: 12,
+      paddingVertical: 6,
+      minHeight: 34,
+      fontSize: 13,
+      borderRadius: 10
+    },
+    md: {
+      paddingHorizontal: 16,
+      paddingVertical: 9,
+      minHeight: 42,
+      fontSize: 15,
+      borderRadius: 12
+    },
+    lg: {
+      paddingHorizontal: 20,
+      paddingVertical: 12,
+      minHeight: 50,
+      fontSize: 16,
+      borderRadius: 14
+    },
+    xl: {
+      paddingHorizontal: 24,
+      paddingVertical: 14,
+      minHeight: 58,
+      fontSize: 17,
+      borderRadius: 16
+    }
+  },
+  input: {
+    sm: {
+      paddingHorizontal: 12,
+      paddingVertical: 8,
+      minHeight: 38,
+      multilineMinHeight: 72,
+      fontSize: 13,
+      borderRadius: 10,
+      iconSize: 16
+    },
+    md: {
+      paddingHorizontal: 14,
+      paddingVertical: 11,
+      minHeight: 46,
+      multilineMinHeight: 92,
+      fontSize: 15,
+      borderRadius: 12,
+      iconSize: 18
+    },
+    lg: {
+      paddingHorizontal: 16,
+      paddingVertical: 14,
+      minHeight: 54,
+      multilineMinHeight: 110,
+      fontSize: 16,
+      borderRadius: 14,
+      iconSize: 20
+    }
+  },
+  searchBar: {
+    sm: {
+      height: 36,
+      paddingHorizontal: 10,
+      fontSize: 13,
+      iconSize: 16,
+      gap: 6
+    },
+    md: {
+      height: 44,
+      paddingHorizontal: 12,
+      fontSize: 15,
+      iconSize: 18,
+      gap: 8
+    },
+    lg: {
+      height: 52,
+      paddingHorizontal: 14,
+      fontSize: 16,
+      iconSize: 20,
+      gap: 10
+    },
+    cancelButtonWidth: 72
+  },
+  emptyState: {
+    sm: {
+      iconSize: 48,
+      titleFontSize: 'lg',
+      descriptionFontSize: 'sm',
+      paddingVertical: 'lg'
+    },
+    md: {
+      iconSize: 64,
+      titleFontSize: 'xl',
+      descriptionFontSize: 'base',
+      paddingVertical: 'xl'
+    },
+    lg: {
+      iconSize: 80,
+      titleFontSize: '2xl',
+      descriptionFontSize: 'base',
+      paddingVertical: '2xl'
+    }
+  },
+  listItem: {
+    sm: {
+      paddingVertical: 'sm',
+      titleFontSize: 'sm',
+      subtitleFontSize: 'xs',
+      minHeight: 44
+    },
+    md: {
+      paddingVertical: 'md',
+      titleFontSize: 'base',
+      subtitleFontSize: 'sm',
+      minHeight: 56
+    },
+    lg: {
+      paddingVertical: 'lg',
+      titleFontSize: 'lg',
+      subtitleFontSize: 'sm',
+      minHeight: 72
+    }
+  },
+  badge: {
+    sm: {
+      fontSize: 10,
+      minWidth: 16,
+      height: 16,
+      paddingHorizontal: 5,
+      dotSize: 8
+    },
+    md: {
+      fontSize: 11,
+      minWidth: 20,
+      height: 20,
+      paddingHorizontal: 6,
+      dotSize: 10
+    },
+    borderWidth: 1.5,
+    anchorOffset: 4
+  },
+  chip: {
+    sm: {
+      paddingHorizontal: 10,
+      paddingVertical: 4,
+      fontSize: 12,
+      minHeight: 26,
+      closeSize: 16,
+      closeFontSize: 12,
+      gap: 6
+    },
+    md: {
+      paddingHorizontal: 12,
+      paddingVertical: 6,
+      fontSize: 13,
+      minHeight: 32,
+      closeSize: 18,
+      closeFontSize: 13,
+      gap: 8
+    }
+  },
+  checkbox: {
+    sm: {
+      boxSize: 16
+    },
+    md: {
+      boxSize: 20
+    },
+    lg: {
+      boxSize: 24
+    },
+    borderWidth: 1.5,
+    labelGap: 10
+  },
+  radio: {
+    sm: {
+      outer: 16,
+      inner: 8
+    },
+    md: {
+      outer: 20,
+      inner: 10
+    },
+    lg: {
+      outer: 24,
+      inner: 12
+    },
+    borderWidth: 1.5,
+    labelGap: 10
+  },
+  switch: {
+    sm: {
+      trackWidth: 42,
+      trackHeight: 26,
+      thumbSize: 22,
+      padding: 2
+    },
+    md: {
+      trackWidth: 51,
+      trackHeight: 31,
+      thumbSize: 27,
+      padding: 2
+    },
+    lg: {
+      trackWidth: 60,
+      trackHeight: 36,
+      thumbSize: 32,
+      padding: 2
+    },
+    thumbColor: '#FFFFFF'
+  },
+  otpInput: {
+    sm: {
+      cell: 36,
+      fontSize: 16,
+      borderRadius: 8,
+      gap: 8
+    },
+    md: {
+      cell: 48,
+      fontSize: 20,
+      borderRadius: 10,
+      gap: 10
+    },
+    lg: {
+      cell: 56,
+      fontSize: 24,
+      borderRadius: 12,
+      gap: 12
+    }
+  },
+  dialog: {
+    iconWrapperSize: 48,
+    iconWrapperBorderRadius: 24,
+    actionButtonMinHeight: 44
+  },
+  toast: {
+    iconCircleSize: 28,
+    iconCircleBorderRadius: 14,
+    iconGlyphFontSize: 16,
+    tintBarWidth: 4
+  },
+  formField: {
+    inlineLabelWidth: '35%'
+  }
+};
 const motion = {
   duration: {
     instant: 80,
@@ -258,7 +512,9 @@ export const lightTheme = {
   spacing,
   radius,
   shadows: lightShadows,
-  motion
+  motion,
+  components,
+  gradients: {}
 };
 export const darkTheme = {
   mode: 'dark',
@@ -310,6 +566,8 @@ export const darkTheme = {
   spacing,
   radius,
   shadows: darkShadows,
-  motion
+  motion,
+  components,
+  gradients: {}
 };
 //# sourceMappingURL=tokens.js.map

package/lib/typescript/commonjs/components/BottomSheet/BottomSheet.d.ts

@@ -19,6 +19,7 @@
 import React from 'react';
 import type { StyleProp, ViewStyle } from 'react-native';
 export type SnapPoint = number | `${number}%`;
+export type KeyboardBehavior = 'none' | 'shift';
 export interface BottomSheetProps {
     snapPoints: SnapPoint[];
     index?: number;
@@ -27,6 +28,15 @@ export interface BottomSheetProps {
     enablePanDownToClose?: boolean;
     enableBackdropPress?: boolean;
     backdropOpacity?: number;
+    /**
+     * How the sheet reacts to the soft keyboard.
+     * - `'none'` (default): the sheet stays put; keyboard may overlap content.
+     * - `'shift'`: animate the sheet upward by the keyboard height while it's
+     *   visible (clamped so the sheet never extends past the top of the screen)
+     *   and animate back when dismissed. Best for forms that live inside the
+     *   sheet itself.
+     */
+    keyboardBehavior?: KeyboardBehavior;
     handleIndicatorStyle?: StyleProp<ViewStyle>;
     containerStyle?: StyleProp<ViewStyle>;
     children?: React.ReactNode;

package/lib/typescript/commonjs/components/Button/Button.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
 import { View } from 'react-native';
 import type { PressableProps, StyleProp, TextStyle, ViewStyle } from 'react-native';
+import type { GradientDefinition } from '../../theme/types';
 import type { HapticType } from '../../utils/hapticUtils';
 export type ButtonVariant = 'solid' | 'outline' | 'ghost' | 'link';
 export type ButtonTone = 'primary' | 'secondary' | 'success' | 'warning' | 'danger' | 'neutral';
@@ -23,6 +24,13 @@ export interface ButtonProps extends Omit<PressableProps, 'style' | 'children'>
     rightIcon?: React.ReactNode;
     haptic?: HapticType | false;
     rounded?: boolean;
+    /**
+     * Optional gradient background. Pass either a key from `theme.gradients`
+     * (e.g. `"primary"`) or a `GradientDefinition` literal. Requires
+     * `react-native-linear-gradient` to be installed; without it the button
+     * falls back to flat colour with a dev warning.
+     */
+    gradient?: string | GradientDefinition;
     style?: StyleProp<ViewStyle>;
     textStyle?: StyleProp<TextStyle>;
     pressAnimation?: boolean;

package/lib/typescript/commonjs/components/Card/Card.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
 import { View } from 'react-native';
 import type { GestureResponderEvent, ImageSourcePropType, PressableProps, StyleProp, ViewStyle } from 'react-native';
+import type { GradientDefinition } from '../../theme/types';
 export type CardVariant = 'elevated' | 'outlined' | 'filled';
 export type CardElevation = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
 export type CardRadius = 'sm' | 'md' | 'lg' | 'xl' | '2xl';
@@ -24,6 +25,13 @@ export interface CardProps extends Omit<PressableProps, 'style' | 'children'> {
      * with shimmer blocks. Use this when the data driving the component is still being fetched.
      */
     loading?: boolean;
+    /**
+     * Optional gradient background. Pass a key from `theme.gradients` or a
+     * literal `GradientDefinition`. Layered behind the card's content so
+     * existing variant/elevation/radius continue to work. Requires
+     * `react-native-linear-gradient` to be installed.
+     */
+    gradient?: string | GradientDefinition;
     onPress?: (event: GestureResponderEvent) => void;
     accessibilityLabel?: string;
     style?: StyleProp<ViewStyle>;

package/lib/typescript/commonjs/components/Dialog/Dialog.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
 export type DialogVariant = 'default' | 'success' | 'warning' | 'danger' | 'info';
 export type DialogActionTone = 'primary' | 'neutral' | 'danger';
 export interface DialogAction {
@@ -17,6 +18,10 @@ export interface DialogProps {
     actions?: DialogAction[];
     dismissOnAction?: boolean;
     accessibilityLabel?: string;
+    /** Style applied to the underlying Modal sheet (consumer may override radius, padding, etc.). */
+    contentStyle?: StyleProp<ViewStyle>;
+    /** Style applied to the dialog inner container (above icon/title/message). */
+    containerStyle?: StyleProp<ViewStyle>;
     testID?: string;
 }
 declare const Dialog: React.FC<DialogProps>;

package/lib/typescript/commonjs/components/Input/Input.d.ts

@@ -20,6 +20,18 @@ export interface InputProps extends Omit<TextInputProps, 'style'> {
     variant?: InputVariant;
     required?: boolean;
     maxLength?: number;
+    /**
+     * Format the raw `value` for display. Common uses: phone-number formatting
+     * ("5551234567" → "(555) 123-4567"), currency, postal codes, masked IDs.
+     * The TextInput shows `format(value)`; user input is passed to `parse` (or
+     * left raw) before reaching `onChangeText`.
+     */
+    format?: (raw: string) => string;
+    /**
+     * Reverse of `format` — strips the formatted display back to the canonical
+     * value the consumer wants in state. If omitted, defaults to identity.
+     */
+    parse?: (formatted: string) => string;
     style?: StyleProp<ViewStyle>;
     inputStyle?: StyleProp<TextStyle>;
     labelStyle?: StyleProp<TextStyle>;

package/lib/typescript/commonjs/components/Skeleton/Skeleton.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
 import type { StyleProp, ViewStyle } from 'react-native';
 import type { RadiusScale } from '../../theme/types';
+import type { SkeletonColors } from './SkeletonProvider';
 export type SkeletonVariant = 'shimmer' | 'pulse';
 export type SkeletonSpeed = 'slow' | 'normal' | 'fast';
 export type SkeletonRadius = keyof Pick<RadiusScale, 'sm' | 'md' | 'lg' | 'xl' | 'full'> | number;
@@ -12,6 +13,14 @@ export interface SkeletonProps {
     radius?: SkeletonRadius;
     variant?: SkeletonVariant;
     speed?: SkeletonSpeed;
+    /**
+     * Per-instance colour override. Either `background` or `highlight` (or both)
+     * can be set; missing keys fall back to the SkeletonProvider's defaults
+     * and finally to the theme. Use this for one-off contrast adjustments
+     * (dark shimmer on a light banner, etc.) — for app-wide overrides prefer
+     * `<SkeletonProvider colors={{...}}>`.
+     */
+    colors?: SkeletonColors;
     style?: StyleProp<ViewStyle>;
     testID?: string;
 }

package/lib/typescript/commonjs/components/Skeleton/SkeletonContent.d.ts

@@ -2,6 +2,7 @@ import React from 'react';
 import type { ReactNode } from 'react';
 import type { StyleProp, ViewStyle } from 'react-native';
 import type { SkeletonSpeed, SkeletonVariant } from './Skeleton';
+import type { SkeletonColors } from './SkeletonProvider';
 export type SkeletonContentMode = 'auto' | 'block';
 export interface SkeletonContentProps {
     /** When true, replace children with skeleton placeholders. */
@@ -26,6 +27,11 @@ export interface SkeletonContentProps {
      * `loading` is false. Default: `1`.
      */
     count?: number;
+    /**
+     * Colour override forwarded to every `<Skeleton>` produced by the walker. Either or both
+     * keys can be set; missing keys fall back to provider defaults / theme.
+     */
+    colors?: SkeletonColors;
     style?: StyleProp<ViewStyle>;
     testID?: string;
 }

package/lib/typescript/commonjs/components/Skeleton/SkeletonList.d.ts

@@ -1,6 +1,7 @@
 import type { ReactElement, ReactNode } from 'react';
 import type { FlatListProps, StyleProp, ViewStyle } from 'react-native';
 import type { SkeletonSpeed, SkeletonVariant } from './Skeleton';
+import type { SkeletonColors } from './SkeletonProvider';
 export interface SkeletonListProps<ItemT> extends Omit<FlatListProps<ItemT>, 'data' | 'renderItem'> {
     /** Whether the list is in its initial loading state. */
     loading: boolean;
@@ -19,6 +20,8 @@ export interface SkeletonListProps<ItemT> extends Omit<FlatListProps<ItemT>, 'da
     variant?: SkeletonVariant;
     /** Animation speed — same as Skeleton. */
     speed?: SkeletonSpeed;
+    /** Colour override forwarded to the placeholder skeletons. */
+    colors?: SkeletonColors;
     /** Style applied to the wrapper View around the placeholders. */
     placeholderContainerStyle?: StyleProp<ViewStyle>;
     testID?: string;

package/lib/typescript/commonjs/components/Skeleton/SkeletonProvider.d.ts

@@ -0,0 +1,32 @@
+import React from 'react';
+import type { ReactNode } from 'react';
+import type { SkeletonRadius, SkeletonSpeed, SkeletonVariant } from './Skeleton';
+/**
+ * Per-instance color override for a skeleton. `background` is the resting tone
+ * of the placeholder; `highlight` is the moving shimmer band (or pulse fade).
+ * Either can be omitted — missing keys fall back to the active theme.
+ */
+export interface SkeletonColors {
+    background?: string;
+    highlight?: string;
+}
+export interface SkeletonProviderDefaults {
+    variant?: SkeletonVariant;
+    speed?: SkeletonSpeed;
+    /** Default `placeholderCount` for `<SkeletonList>` when not specified per-instance. */
+    placeholderCount?: number;
+    /** Default `radius` for `<Skeleton>` when not specified per-instance. */
+    radius?: SkeletonRadius;
+    /** App-wide colour overrides for the shimmer base + highlight. */
+    colors?: SkeletonColors;
+}
+export interface SkeletonProviderProps extends SkeletonProviderDefaults {
+    children: ReactNode;
+}
+export declare const SkeletonProvider: React.FC<SkeletonProviderProps>;
+/**
+ * Read the current SkeletonProvider defaults. Returns an empty object when no
+ * provider is mounted, so the skeleton primitives still work outside of one.
+ */
+export declare const useSkeletonDefaults: () => SkeletonProviderDefaults;
+//# sourceMappingURL=SkeletonProvider.d.ts.map

package/lib/typescript/commonjs/components/Skeleton/SkeletonSkip.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+import type { ReactNode } from 'react';
+export interface SkeletonSkipProps {
+    children: ReactNode;
+}
+/**
+ * Pass-through marker that opts a subtree out of `SkeletonContent`'s auto walker.
+ *
+ * The walker recognizes this element type and returns its children unchanged
+ * even while `loading` is true. Use it to keep a specific Text/Image/View
+ * visible inside a skeleton block — e.g., a brand mark, a status icon, or a
+ * decorative element that should never shimmer.
+ *
+ * @example
+ *   <SkeletonContent loading>
+ *     <View style={styles.card}>
+ *       <SkeletonSkip>
+ *         <Image source={Logo} style={styles.brandMark} />
+ *       </SkeletonSkip>
+ *       <Text>Loading…</Text>
+ *     </View>
+ *   </SkeletonContent>
+ */
+export declare const SkeletonSkip: React.FC<SkeletonSkipProps>;
+//# sourceMappingURL=SkeletonSkip.d.ts.map

package/lib/typescript/commonjs/components/Skeleton/index.d.ts

@@ -4,4 +4,8 @@ export { SkeletonContent } from './SkeletonContent';
 export type { SkeletonContentProps, SkeletonContentMode } from './SkeletonContent';
 export { SkeletonList } from './SkeletonList';
 export type { SkeletonListProps } from './SkeletonList';
+export { SkeletonProvider, useSkeletonDefaults } from './SkeletonProvider';
+export type { SkeletonColors, SkeletonProviderDefaults, SkeletonProviderProps } from './SkeletonProvider';
+export { SkeletonSkip } from './SkeletonSkip';
+export type { SkeletonSkipProps } from './SkeletonSkip';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/components/Switch/Switch.d.ts

@@ -13,6 +13,11 @@ export interface SwitchProps extends Omit<PressableProps, 'style' | 'children' |
     label?: string;
     accessibilityLabel?: string;
     haptic?: HapticType | false;
+    /**
+     * When true, the thumb briefly scales up on value change (1 → 1.15 → 1).
+     * Use for playful/brand-flavored switches; default off for system feel.
+     */
+    bounce?: boolean;
     style?: StyleProp<ViewStyle>;
     trackStyle?: StyleProp<ViewStyle>;
     thumbStyle?: StyleProp<ViewStyle>;

package/lib/typescript/commonjs/components/Toast/Toast.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import type { StyleProp, TextStyle, ViewStyle } from 'react-native';
 import type { HapticType } from '../../utils/hapticUtils';
 export type ToastVariant = 'default' | 'success' | 'error' | 'warning' | 'info';
 export type ToastPosition = 'top' | 'bottom';
@@ -15,6 +16,10 @@ export interface ToastOptions {
     action?: ToastAction;
     haptic?: HapticType | false;
     icon?: React.ReactNode;
+    /** Style applied to the toast container (override radius, padding, shadow per-toast). */
+    style?: StyleProp<ViewStyle>;
+    /** Style applied to the toast message Text. */
+    textStyle?: StyleProp<TextStyle>;
 }
 export interface ToastItem extends ToastOptions {
     id: string;

package/lib/typescript/commonjs/components/index.d.ts

@@ -70,8 +70,8 @@ export { Select } from './Select';
 export type { SelectProps, SelectOption, SelectSize } from './Select';
 export { Stepper } from './Stepper';
 export type { StepperProps, StepperVariant, StepperStep, StepperTone } from './Stepper';
-export { Skeleton, SkeletonAvatar, SkeletonCard, SkeletonCircle, SkeletonContent, SkeletonList, SkeletonListItem, SkeletonText } from './Skeleton';
-export type { SkeletonProps, SkeletonAvatarProps, SkeletonCardProps, SkeletonCircleProps, SkeletonContentMode, SkeletonContentProps, SkeletonListItemProps, SkeletonListProps, SkeletonTextProps, SkeletonVariant, SkeletonSpeed } from './Skeleton';
+export { Skeleton, SkeletonAvatar, SkeletonCard, SkeletonCircle, SkeletonContent, SkeletonList, SkeletonListItem, SkeletonProvider, SkeletonSkip, SkeletonText, useSkeletonDefaults } from './Skeleton';
+export type { SkeletonAvatarProps, SkeletonCardProps, SkeletonCircleProps, SkeletonColors, SkeletonContentMode, SkeletonContentProps, SkeletonListItemProps, SkeletonListProps, SkeletonProps, SkeletonProviderDefaults, SkeletonProviderProps, SkeletonSkipProps, SkeletonSpeed, SkeletonTextProps, SkeletonVariant } from './Skeleton';
 export { Slider } from './Slider';
 export type { SliderProps, SliderTone, SliderSize } from './Slider';
 export { Swipeable } from './Swipeable';

package/lib/typescript/commonjs/theme/Gradient.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+import type { GradientDefinition } from './types';
+export interface GradientProps {
+    gradient: GradientDefinition;
+    style?: StyleProp<ViewStyle>;
+    children?: React.ReactNode;
+}
+export declare const Gradient: React.FC<GradientProps>;
+export declare const isGradientAvailable: () => boolean;
+//# sourceMappingURL=Gradient.d.ts.map

package/lib/typescript/commonjs/theme/index.d.ts

@@ -9,5 +9,9 @@ export { ThemeProvider, useTheme, useThemeMode } from './ThemeContext';
 export type { ThemeProviderProps, ColorSchemePreference } from './ThemeContext';
 export { lightTheme, darkTheme } from './tokens';
 export { mergeTheme } from './merge';
-export type { ColorMode, ColorPalette, RadiusScale, ShadowDefinition, ShadowScale, SpacingScale, Theme, ThemeOverrides, TypographyScale, MotionScale, DeepPartial } from './types';
+export { fontFor } from './textStyle';
+export type { FontWeightKey } from './textStyle';
+export { Gradient, isGradientAvailable } from './Gradient';
+export type { GradientProps } from './Gradient';
+export type { ColorMode, ColorPalette, GradientDefinition, GradientScale, RadiusScale, ShadowDefinition, ShadowScale, SpacingScale, Theme, ThemeOverrides, TypographyScale, MotionScale, DeepPartial } from './types';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/theme/textStyle.d.ts

@@ -0,0 +1,18 @@
+import type { TextStyle } from 'react-native';
+import type { Theme, TypographyScale } from './types';
+export type FontWeightKey = keyof TypographyScale['fontWeight'];
+/**
+ * Resolve text-weight style for the active theme.
+ *
+ * When the consumer registers a brand `theme.typography.fontFamily.<weight>`,
+ * we set `fontFamily` and leave `fontWeight` undefined — RN can't combine the
+ * two reliably across iOS/Android once a custom face is in play, so the brand
+ * file controls the weight glyph itself. Falls back to `fontWeight` when no
+ * brand font is registered for that weight.
+ *
+ * Note: the fontWeight scale uses `normal` while FontFamilyScale uses
+ * `regular` (the conventional font-name suffix). The helper maps between
+ * them transparently.
+ */
+export declare const fontFor: (theme: Theme, weight: FontWeightKey) => Pick<TextStyle, "fontFamily" | "fontWeight">;
+//# sourceMappingURL=textStyle.d.ts.map