/****************************************************************************

**

** Copyright (C) 2008-2010 Nokia Corporation and/or its subsidiary(-ies).

** All rights reserved.

** Contact: Nokia Corporation (developer.feedback@nokia.com)

**

** This file is part of the HbPlugins module of the UI Extensions for Mobile.

**

** GNU Lesser General Public License Usage

** This file may be used under the terms of the GNU Lesser General Public

** License version 2.1 as published by the Free Software Foundation and

** appearing in the file LICENSE.LGPL included in the packaging of this file.

** Please review the following information to ensure the GNU Lesser General

** Public License version 2.1 requirements will be met:

** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

**

** In addition, as a special exception, Nokia gives you certain additional

** rights.  These rights are described in the Nokia Qt LGPL Exception

** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

**

** If you have questions regarding the use of this file, please contact

** Nokia at developer.feedback@nokia.com.

**

****************************************************************************/

#include "hbautocomplete.h"

#include <hbinputextrauserdictionary.h>

#include <hbinputextradictionarycollection.h>

#include <hbinputextradictionaryfactory.h>

/// @cond

class HbAutoCompletePrivate

{

public:

    HbAutoCompletePrivate() 

         : mActiveDictionary(0),

           mActiveCollection(0),

           mCandidatesOutdated(false)

    {}

public:

    HbExtraUserDictionary *mActiveDictionary;

    HbExtraDictionaryCollection *mActiveCollection;

    QString mCurrentWord;

    QStringList mCandidates;

    bool mCandidatesOutdated;

    QList<HbInputLanguage> mLanguages;

};

/// @endcond

const QString HbAutoCompleteEngineVersion("0.1");

/*!

Constructs the object.

*/

HbAutoComplete::HbAutoComplete() : d_ptr(new HbAutoCompletePrivate) 

{

    Q_D(HbAutoComplete);

    d->mLanguages.append(HbInputLanguage());

}

/*!

Destructs the object.

*/ 

HbAutoComplete::~HbAutoComplete()

{

    delete d_ptr;

}

/*!

Reuturns list of supported languages. This engine can be used with any input language so it just returns

a list containing HbInputLanguageAny.

*/

QList<HbInputLanguage> HbAutoComplete::languages() const

{

    Q_D(const HbAutoComplete);

    return QList<HbInputLanguage>(d->mLanguages);

}

/*!

Handles delete key press. 

*/

void HbAutoComplete::deleteKeyPress(HbPredictionCallback* callback)

{

    Q_UNUSED(callback)

    Q_D(HbAutoComplete);

    d->mCurrentWord.chop(1);

    d->mCandidatesOutdated = true;

}

/*!

Commits active word. Word is added to the dictionry (unless it isn't there already)

and the use count is increased. In case of collection, the word is added to the first 

dictionary in the collection unless it already exits in at least one of them.

*/

void HbAutoComplete::commit(const QString &word)

{

    Q_UNUSED(word);

    Q_D(HbAutoComplete);

    if (d->mCurrentWord.size()) {

        addUsedWord(d->mCurrentWord);

    }

    clear();

}

/*!

Clears active word.

*/

void HbAutoComplete::clear()

{

    Q_D(HbAutoComplete);

    d->mCurrentWord.clear();

    d->mCandidates.clear();

}

/*!

Adds word to active dictionary or collection if it doesn't already exits theer and increases the 

use frequency counter. In case of a collection, word is added to the first enabled dictionary.

*/

void HbAutoComplete::addUsedWord(const QString& word)

{

    Q_D(HbAutoComplete);

    if (word.size() > 0) {

        if (d->mActiveDictionary) {

            d->mActiveDictionary->addWord(word);

            d->mActiveDictionary->incrementUseCount(word);

        } else if (d->mActiveCollection) {

            if (!d->mActiveCollection->hasWord(word)) {

                QList<int> dictionaries = d->mActiveCollection->dictionaries();

                for (int i = 0; i < dictionaries.count(); i++) {

                    if (!d->mActiveCollection->isDisabled(dictionaries[i])) {

                        HbExtraUserDictionary *firstOne = HbExtraDictionaryFactory::instance()->existingDictionary(dictionaries.at(i));

                        if (firstOne) {

                            firstOne->addWord(word);

                        }

                    }

                }

            } else {

                d->mActiveCollection->incrementUseCount(word);

            }

        }

    } 

}

/*!

Handles key presses. Empty implementation, isn't used at the moment. 

*/

void HbAutoComplete::appendKeyPress(const int keycode, const Qt::KeyboardModifiers modifiers, const HbTextCase textCase, HbPredictionCallback* callback)

{

    Q_UNUSED(keycode)

    Q_UNUSED(modifiers)

    Q_UNUSED(textCase)

    Q_UNUSED(callback)

}

/*!

Sets active word.

*/

void HbAutoComplete::setWord(const QString& word, HbPredictionCallback* callback)

{

    Q_UNUSED(callback)

    Q_D(HbAutoComplete);

    if (word.size() < KExtraUserDictionaryMaxWordLength) {

        d->mCurrentWord = word;

        d->mCandidatesOutdated = true;

    }

}

void HbAutoComplete::updateCandidates(int& bestGuessLocation, bool& noMoreCandidates)

{

    Q_D(HbAutoComplete);

    bestGuessLocation = 0;

    noMoreCandidates = false;

    if (d->mCandidatesOutdated) {

        if (d->mActiveDictionary && d->mCurrentWord.size() > 0) {

            d->mCandidates = d->mActiveDictionary->findMatches(d->mCurrentWord, true); 

        } else if (d->mActiveCollection &&  d->mCurrentWord.size() > 0) {

            d->mCandidates = d->mActiveCollection->findMatches(d->mCurrentWord); 

        }

        d->mCandidatesOutdated = false;

    }

}

/*!

returns a bit vector of supported prediction features.

*/ 

HbInputPredictionFeature HbAutoComplete::features() const

{

    return (HbInputPredictionFeature)(HbPredFeatureExtraDictionaries | HbPredFeatureWordCompletion);

}

/*!

Returns vendor id string. 

*/

QString HbAutoComplete::vendorIdString() const

{

    return HbAutoCompleteVendorIdString;	

}

/*!

Returns engine version string.

*/

QString HbAutoComplete::engineVersion() const

{

    return HbAutoCompleteEngineVersion;

}

/*!

Returns true if the engine supports given language / keyboard combination. In case of HbAutoCompletion,

this method always returns true because the keyboard doesn't matter.

*/

bool HbAutoComplete::supportsKeyboardType(const HbInputLanguage &language, HbKeyboardType keyboard) const

{

    Q_UNUSED(language)

    Q_UNUSED(keyboard)

    // Keyboard doesn't matter, all the communication is done via

    // appendKeyPressUnicode for now.

    return true;

}

/*!

Sets active dictionary. Previous active dictionary or collection is disabled.

*/

void HbAutoComplete::setExtraUserDictionary(int aId)

{

    Q_D(HbAutoComplete);

   // Deactivate possible collection.

    delete d->mActiveCollection;

    d->mActiveCollection = 0;

    d->mActiveDictionary = HbExtraDictionaryFactory::instance()->createDictionary(aId);

	if (d->mActiveDictionary) {

		d->mActiveDictionary->setHostEngine(this);

	}

    clear();

}

/*!

Sets active dictionary collection. Previous active dictionary or collection is disabled.

*/

void HbAutoComplete::setExtraUserDictionaries(const QList<int>& idList)

{

    Q_UNUSED(idList)

    Q_D(HbAutoComplete);

    d->mActiveDictionary = 0;  // Not owned, so doesn't need to be deleted.

    delete d->mActiveCollection;

    d->mActiveCollection = new HbExtraDictionaryCollection(idList);

    clear();

}

/*!

Returns the length of current input sequence.

*/

int HbAutoComplete::inputLength()

{

    Q_D(HbAutoComplete);

    return d->mCurrentWord.size();

}

/*!

An empty implementation. Not needed in HbAutoCompletion.

*/

void HbAutoComplete::setCandidateList(QStringList* candidateList)

{

    Q_UNUSED(candidateList)

}

/*!

Returns current candidate list. Reconstructs the list only when it is out of date.

*/

QStringList HbAutoComplete::candidateList()

{

    Q_D(HbAutoComplete);

    if (d->mCandidatesOutdated) {

        if (d->mActiveDictionary && d->mCurrentWord.size() > 0) {

            d->mCandidates = d->mActiveDictionary->findMatches(d->mCurrentWord, true); 

        } else if (d->mActiveCollection && d->mCurrentWord.size() > 0) {

            d->mCandidates = d->mActiveCollection->findMatches(d->mCurrentWord);

        } else {

            d->mCandidates.clear();

        }

        d->mCandidatesOutdated = false;

    }

    return QStringList(d->mCandidates);

}

/*!

Sets keyboard type. This method is not needed in HbAutoCompletion.

*/

void HbAutoComplete::setKeyboard(HbKeyboardType aKeyboardType)

{

    Q_UNUSED(aKeyboardType)

}

/*!

Appends new character to be used as part of the input sequence. The candidate list is flagged to be

out of date.

*/

void HbAutoComplete::appendCharacter(const QChar aChar, const HbTextCase textCase, HbPredictionCallback* callback)

{

    Q_UNUSED(callback)

    Q_UNUSED(textCase)

    Q_D(HbAutoComplete);

    if (d->mCurrentWord.size() < KExtraUserDictionaryMaxWordLength) {

        d->mCurrentWord.append(aChar);

        d->mCandidatesOutdated = true;

    }

}

// End of file