progress on searching auto type candidates

MacPass/MPAutotypeCommand.h

@@ -8,10 +8,38 @@
 
 #import <Foundation/Foundation.h>
 
+/**
+ *  The Autotype command reperesent a capsualted Action that was determined by interpreting
+ *  Autotype field for a given entry. This is a class cluster and schould be considered the sole
+ *  enty point for creating AutotypeCommands.
+ */
 @interface MPAutotypeCommand : NSObject
 
-@property (copy) NSString *commandString;
+@property (readonly, copy) NSString *commandString;
 
++ (NSArray *)commandsForCommandString:(NSString *)commands;
+/**
+ *  Determines the Keycode for the given keyboard layout for the supplied character
+ *
+ *  @param uchrHeader The KeyboardLayout
+ *  @param character  The Character that needs to be pressed
+ *
+ *  @return Key code in the supplied keyboard layout
+ */
+- (CGKeyCode)keyCodeForKeyboard:(const UCKeyboardLayout *)uchrHeader character:(NSString *)character;
+/**
+ *  Sends a KeyPress Event with the supplied modifier flags and Keycode
+ *  Any existing modifiers will be disabled for this event. If the user
+ *  presses any key, those will be ignored during this event
+ *
+ *  @param keyCode virtual KeyCode to be sent
+ *  @param flags   modifier flags for the key press event
+ */
+- (void)sendPressKey:(CGKeyCode)keyCode modifierFlags:(CGEventFlags)flags;
+
+/**
+ *  Exectues the Autotype Command. This will be called by the autotype daemon.
+ */
 - (void)execute;
 
 @end