/*
* Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:  Manages Ai3 personalization
*
*/


#ifndef C_XNEDITOR_H
#define C_XNEDITOR_H

// System includes
#include <e32base.h>
#include <badesca.h>
#include <hscontentcontroller.h>
#include <hscontentinfo.h>
#include <hscontentinfoarray.h>
#include <AknsSrvClient.h>

// User includes
#include "hspswrapper.h"
#include "cpswrapper.h"
#include "xnviewmanager.h"

// Forward declarations
class CXnNode;
class CAknListQueryDialog;
class CXnViewManager;
class CXnViewData;
class CRepository;
class CXnBackgroundManager;

namespace hspswrapper
    {
    class CPropertyMap;
    class CAddPluginResult;
    class MHspsWrapperObserver;    
    }

namespace cpswrapper
    {
    class CCpsWrapper;
    class CPublisherMap;
    class CPublisherInfo; 
    class MCpsWrapperObserver;
    }

using namespace hspswrapper;
using namespace cpswrapper;

// Class declaration

/**
 *  Editor handles ai3 personalization
 *
 *  @ingroup group_xnlayoutengine
 *  @lib xn3layoutengine.lib
 *  @since S60 5.0
 */
NONSHARABLE_CLASS( CXnEditor ) : public CBase, 
    public MXnViewObserver,
    public MCpsWrapperObserver,
    public MHspsWrapperObserver,
    public MHsContentController
    {
public:
    //constructors and destructor
    
    /**
     * Two-phased constructor.
     * 
     * @param aViewManager View manager
     * @param aWrapper HSPS wrapper
     */
    static CXnEditor* NewL( CXnViewManager& aViewManager,
        const TDesC8& aUid );
    
    /**
     * Two-phased constructor.
     * 
     * @param aViewManager View manager
     * @param aWrapper HSPS wrapper
     */
    static CXnEditor* NewLC( CXnViewManager& aViewManager,
        const TDesC8& aUid );

    /**
     * Destructor.
     */
    ~CXnEditor();

public:
    // new functions    
    
    /**
     * Remove uregistered widget from all the views.
     *
     * @since S60 5.0
     * @param aPublisher publisher
     */
    void RemoveUnRegisteredWidgetL( const TDesC& aPublisher );

    /**
     * Removes uninstalled widget from all views
     * 
     * @since S60 5.0
     * @param aContentInfo content info
     */
    void RemoveUnInstalledWidgetL( const CHsContentInfo& aContentInfo );

    /**
     * Runs add widget list query
     * 
     * @since S60 5.0     
     */
    void AddWidgetL();

    /**
     * Remove widget from current view.
     *
     * @since S60 5.0
     * @param aNode Plugin (or its child) where to remove widget.     
     */
    void RemoveWidgetL( CXnNode* aNode );

    /**
     * Replaces widget configuration to HSPS
     * 
     * @since S60 5.0
     * @param aContentInfo content info 
     */
    void ReplaceWidgetL( CHsContentInfo& aContentInfo, TBool aUseHsps = ETrue );
    /**
     * Commit a new order of plugins to the HSPS.
     * 
     * @since S60 5.0
     * @param aPluginArray Array of plugins
     */
    void ReorderWidgetsL( RPointerArray< CXnNode >* aPluginArray );

    /**
     * Toggles widgets' visibility
     * 
     * @since S60 5.0
     * @return Current widgets' visibility state
     */
    TBool ToggleWidgetsVisibiltyL();

    /**
     * Queries wheter the widgets are visible or not
     * 
     * @since S60 5.0
     * @return ETrue if widgets are now visible, EFalse otherwise
     */
    TBool WidgetsVisible() const;

    /**
     * Sets target plugin for add/remove
     * 
     * @since S60 5.0
     * @param aNode a plugin node to be set as target for add/remove action
     */
    void SetTargetPlugin( CXnNode* aNode );

    /**
     * Handles changing of wallpaper
     * 
     * @since S60 5.0
     */
    void SetWallpaperL();
    
    /**
     * Returns the HSPS Wrapper object owned by this.
     * 
     * @since S60 5.0
	 * @return HSPSWrapper
     */
    CHspsWrapper& HspsWrapper() const;

    /**
     * Retrives Id read from central repository.
     * 
     * @since S60 5.0
	 * @return sucess or failure standard error code
     */    
    TInt IdFromCrep ( TDes8& aUid ) const;

private:
    // from MHsContentController
    
    TInt WidgetListL( CHsContentInfoArray& aArray );
    
    TInt ViewListL( CHsContentInfoArray& aArray );
    
    TInt AppListL( CHsContentInfoArray& aArray );
    
    TInt AddWidgetL( CHsContentInfo& aInfo );
    
    TInt RemoveWidgetL( CHsContentInfo& aInfo );
    
    TInt AddViewL( CHsContentInfo& aInfo );
    
    TInt RemoveViewL( CHsContentInfo& aInfo );
    
    TInt ActivateViewL( CHsContentInfo& aInfo );
    
    TInt ActivateAppL( CHsContentInfo& aInfo );

    TInt ActiveViewL( CHsContentInfo& aInfo );
    
    TInt ActiveAppL( CHsContentInfo& aInfo );

private:
    // constructors
    
    /**
     * C++ constructor
     */
    CXnEditor( CXnViewManager& aViewManager );

    /**
     * Leaving constructor
     */
    void ConstructL( const TDesC8& aUid );

private:
    // new functions    
    
    void TemplatedWidgetsL( RPointerArray< CHsContentInfo >& aWidgets );

    void HSPSPluginsL( RPointerArray< CHsContentInfo >& aWidgets,
        const TDesC8& aType );

    CPublisherInfo* PublisherInfoL( const CHsContentInfo& aContentInfo );

    TInt TemplateWidgetCanBeAddedRemovedL( CHsContentInfo& aContentInfo );
    TInt NonTemplateWidgetCanBeAddedRemovedL( CHsContentInfo& aContentInfo );
    
    TBool IsCurrentViewFull();
    void FilterWidgetListL( CHsContentInfoArray& aContentInfoArray,
        TBool aIgnoreViewFull );
    void FilterViewListL( CHsContentInfoArray& aContentInfoArray ); 
    
    /**
     * Notifies the MHsContentControl and the MHsContentControlUi if widget list was changed.
     */
    void WidgetListChanged();

    /**
     * Notifies the MHsContentControl and the MHsContentControlUi if view list was changed.
     */
    void ViewListChanged();

private:
    // from MXnViewObserver    
    
    void NotifyViewActivatedL( const CXnViewData& aViewData );

    void NotifyViewDeactivatedL( const CXnViewData& /*aViewData*/ );

    void NotifyConfigureWidgetL( const CHsContentInfo& aContentInfo,
        CXnPluginData& aPluginData );

    void NotifyWidgetAdditionL( const CXnPluginData& aPluginData );
    
    void NotifyWidgetRemovalL( const CXnPluginData& aPluginData );

    void NotifyViewAdditionL( const CXnPluginData& /*aPluginData*/ );
    
    void NotifyViewRemovalL( const CXnPluginData& /*aPluginData*/ );

private:
    // from MCpsWrapperObserver    
 
    void NotifyWidgetUnregisteredL( const TDesC& aPublisher );
    
    void NotifyWidgetRegisteredL();
    
private:
    // from MHspsWrapperObserver

    TInt HandleNotifyL( const TDesC8& aEvent, const TDesC8& aAppConfUid,
        const TDesC8& aPluginName, const TDesC8& aOrigUid, 
        const TDesC8& aPluginUid, const TDesC8& aPluginId );    

private:
    // data

    /** View manager, not owned */
    CXnViewManager& iViewManager;
    /** HSPS wrapper, owned */
    CHspsWrapper* iHspsWrapper;  
    /** CPS wrapper, owned */
    CCpsWrapper* iCpsWrapper;
    /** Publisher map, owned */
    CPublisherMap* iPublisherMap;
    /** Add widget listquery, not owned */
    CAknListQueryDialog* iQuery;
    /** Target plugin for add/remove, not owned */
    CXnNode* iTargetPlugin;
    /** Widgets visibility state */
    TBool iWidgetsVisibilityState;    
    /** Central repository , to choose plugin, owned*/
    CRepository* iRepository;
    };

#endif // C_XNEDITOR_H