Callback to be invoked before formatting. Implementation is allowed to do the following:
-
return not given text range but adjusted one. E.g. we want to reformat a field at a java class but
have 'align field in columns' settings on. That's why the range should be expanded in order to
cover all fields group;
-
another use-case might be target PSI file/document modification (e.g. change words case). The only requirement here
is that given element stays valid;
Note: the callback might expect to be called for every injected root at the target formatting context.