     event_builder.type = 'coffee_state_machine.EventHelperFunction'
 
 
-    # transition helper function
-    #
+    # ========================================
+    # TRANSITION helper function
+    # ========================================
+
     append_common_state_trans_options = (trans_def, ifCallback, unlessCallback, doAction) ->
         trans_def.if = ifCallback if typeof ifCallback is 'function'
         trans_def.unless = unlessCallback if typeof unlessCallback is 'function'

    create_state_transitions = (stateTransitionMap, transitionHook) ->
        trans_map = current_state_transitions()
        for onState, toState of stateTransitionMap
            trans_map[onState] = create_state_trans_def onState, toState, undefined, undefined, transitionHook

    transition_builder = (args...) ->
        # inside event definition?

        obj = options.extend ? {}


    # ========================================
    # STATE helper function
    # ========================================

    all_states = {}
    state_hooks = {}

