feat: update Pressable configuration to include baseScale and adjust scale interpolation

Author: enzomanuelmangano

src/pressables/custom/scale.ts

@@ -6,7 +6,7 @@ export const PressableScale = createAnimatedPressable((progress, { config }) =>
   return {
     transform: [
       {
-        scale: interpolate(progress, [0, 1], [config.maxScale, config.minScale]),
+        scale: interpolate(progress, [0, 1], [config.baseScale, config.minScale]),
       },
     ],
   };

src/provider/constants.ts

@@ -1,9 +1,55 @@
 import { Easing } from 'react-native-reanimated';
 
+/**
+ * Configuration values for pressable visual feedback
+ */
 export type PressableConfig = {
+  /**
+   * Target opacity when the pressable is in active/pressed state.
+   *
+   * Used by PressableOpacity to interpolate from 1 (idle) to this value (pressed).
+   *
+   * @default 0.5
+   * @example
+   * // More transparent when pressed
+   * config={{ activeOpacity: 0.3 }}
+   *
+   * // Less transparent when pressed
+   * config={{ activeOpacity: 0.7 }}
+   */
   activeOpacity: number;
+
+  /**
+   * Target scale when the pressable is in active/pressed state.
+   *
+   * Used by PressableScale to interpolate from baseScale (idle) to this value (pressed).
+   * Values less than baseScale create a "shrink" effect.
+   *
+   * @default 0.96
+   * @example
+   * // More pronounced shrink effect
+   * config={{ minScale: 0.9 }}
+   *
+   * // Subtle shrink effect
+   * config={{ minScale: 0.98 }}
+   */
   minScale: number;
-  maxScale: number;
+
+  /**
+   * Base scale when the pressable is in idle/unpressed state.
+   *
+   * Used by PressableScale as the starting scale value.
+   * Typically set to 1, but can be adjusted for special effects.
+   *
+   * @default 1
+   * @example
+   * // Normal size when idle
+   * config={{ baseScale: 1 }}
+   *
+   * // Slightly enlarged when idle (grows when pressed if minScale > 1)
+   * config={{ baseScale: 1.05, minScale: 1.1 }}
+   */
+  baseScale: number;
 };
 
 export const DefaultAnimationConfigs = {
@@ -15,8 +61,11 @@ export const DefaultAnimationConfigs = {
   },
 } as const;
 
+/**
+ * Default configuration values for pressable visual feedback
+ */
 export const DefaultPressableConfig: PressableConfig = {
   activeOpacity: 0.5,
   minScale: 0.96,
-  maxScale: 1,
+  baseScale: 1,
 } as const;