import { GroupPosition, GroupOrientation } from './types';
/**
 * Calculate element position within a group based on index and total count
 *
 * @param index - Current element index (0-based)
 * @param totalCount - Total number of elements in group
 * @param orientation - Group orientation (horizontal or vertical)
 * @returns Position enum value or undefined if single element
 */
export declare function getGroupPosition(index: number, totalCount: number, orientation?: GroupOrientation): GroupPosition | undefined;
/**
 * Get gap value for group based on stacked mode and orientation
 * Uses foundation tokens if gap is not provided
 *
 * @param stacked - Whether group is in stacked mode (no gap)
 * @param providedGap - User-provided gap value
 * @param orientation - Group orientation enum
 * @returns Gap value as string or number
 */
export declare function getGroupGap(stacked: boolean, providedGap?: string | number, orientation?: GroupOrientation): string | number;
/**
 * Helper to convert position prop name to match component's expected prop
 * This allows the Group to work with different component APIs
 *
 * @example
 * // For ButtonV2
 * getPositionPropName('buttonGroupPosition') // 'buttonGroupPosition'
 *
 * // For Tag
 * getPositionPropName('splitTagPosition') // 'splitTagPosition'
 *
 * @param propName - Name of the position prop
 * @returns The same prop name (identity function for type safety)
 */
export declare function getPositionPropName(propName?: string): string;