The API would function as a toggle or setter between the two modes.
I want this feature primarily to use TreeStyleTab, but think Firefox should be as customizable as possible for the benefit of the client.
There is already a thread for it on bugzilla...