package votorola.s.gwt.stage.poll; // Copyright 2012, Michael Allan.  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Votorola Software"), to deal in the Votorola Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicence, and/or sell copies of the Votorola Software, and to permit persons to whom the Votorola Software is furnished to do so, subject to the following conditions: The preceding copyright notice and this permission notice shall be included in all copies or substantial portions of the Votorola Software. THE VOTOROLA SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE VOTOROLA SOFTWARE OR THE USE OR OTHER DEALINGS IN THE VOTOROLA SOFTWARE.

import com.google.gwt.core.client.GWT;
import com.google.gwt.uibinder.client.*;
import com.google.gwt.user.client.ui.*;
import com.google.web.bindery.event.shared.HandlerRegistration;
import java.util.*;
import votorola.a.count.*;
import votorola.g.hold.*;
import votorola.g.lang.*;
import votorola.g.web.gwt.*;
import votorola.g.web.gwt.event.*;
import votorola.s.gwt.stage.*;


/** A view of a {@linkplain Polltrack polltrack}.  It comprises a sequence of compressed
  * {@linkplain PollV poll views} (one per poll), ordered alphabetically from left to
  * right according to the last component of the poll name ("sandbox" in the illustration
  * below).  When a poll is {@linkplain Stage#getPollName() staged} or cued by the mouse,
  * the corresponding view expands (X).<pre>
  *
  *                                     {@linkplain HeadsUpDisplay heads up display}
  *    staged poll                       /
  *             \                       /
  *              \          Sys/p/sandbox
  -   ------------X---------------X--------------------
  *                                \
  *                                 \
  *                                 poll cued by mouse</pre>
  *
  *     @see <a href='../../../../../../../s/gwt/stage/poll/PolltrackV.ui.xml'
  *                                                        >PolltrackV.ui.xml</a>
  */
public final class PolltrackV extends Composite
{


    /** Constructs a PolltrackV.
      */
    PolltrackV( Polltrack _track )
    {
        track = _track;
        new Modeller();
    }



    /** Returns the {@linkplain StageV staged instance} of PolltrackV, or null if none is
      * staged.
      */
    public static PolltrackV i( final StageV stageV )
    {
        final Iterator<Widget> ww = stageV.iterator();
        while( ww.hasNext() )
        {
            final Widget w = ww.next();
            if( w instanceof PolltrackV ) return (PolltrackV)w;
        }

        return null;
    }


        private static PolltrackV instance; // not necessarily staged, though actually it will be

        {
            if( instance != null ) throw new IllegalStateException(); // grep "instance" for reason

            instance = PolltrackV.this;
        }



   // ` e a r l y ````````````````````````````````````````````````````````````````````````


    private final Spool spool = new Spool1();



    @Warning("non-API") interface UiBinderI extends UiBinder<HTMLPanel,PolltrackV> {}

        {
            final UiBinderI uiBinder = GWT.create( UiBinderI.class );
            initWidget( uiBinder.createAndBindUi( PolltrackV.this ));
        }



   // - C o m p o s i t e ----------------------------------------------------------------


    protected @Override HTMLPanel getWidget() { return (HTMLPanel)super.getWidget(); }



   // - W i d g e t ----------------------------------------------------------------------


    protected @Override void onUnload()
    {
        super.onUnload();
        spool.unwind();
    }



    public @Override void removeFromParent()
    {
        if( getParent() != null ) throw new UnsupportedOperationException();
    }



//// P r i v a t e ///////////////////////////////////////////////////////////////////////


    @UiField @Warning("non-API") FlowPanel listV;



      @UiFactory @Warning("non-API")
    HeadsUpDisplay newHeadsUp() { return new HeadsUpDisplay( PolltrackV.this, spool ); }



    private final Polltrack track;



   // ====================================================================================


    private final class Modeller implements ChangeHandler
    {

        Modeller()
        {
            spool.add( new Hold()
            {
                final HandlerRegistration hR = GWTX.i().bus().addHandlerToSource(
                  Change.TYPE, /*source*/track.eventSource, Modeller.this );
                public void release() { hR.removeHandler(); }
            });
            remodel();
        }


        public void onChange( Change _e ) { remodel(); }


        private void remodel()
        {
            if( spool.isUnwinding() ) return;

            int p = 0;
            int pVN = listV.getWidgetCount();
            final int pN = track.size();
            for(; p < pN; ++p ) // for tracked polls, remodel the views
            {
                final PollV pollV;
                if( p == pVN )
                {
                    pollV = new PollV( spool );
                    listV.add( pollV );
                    ++pVN;
                }
                else pollV = (PollV)listV.getWidget( p );
                pollV.setPoll( track.get( p ));
            }
            for(; p < pVN; ++p ) // for remaining views, clear the models
            {
                final PollV pollV = (PollV)listV.getWidget( p );
                pollV.setPoll( null );
            }
        }

    }


}