The theater season that just ended was remarkably lucrative as producers have become more sophisticated, and more aggressive, about setting prices.