translationutils.h

Go to the documentation of this file.

// Copyright (C) 2025 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only WITH Qt-GPL-exception-1.0
 
#ifndef TRANSLATIONUTILS_H
#define TRANSLATIONUTILS_H
 
#include <QtCore/qhash.h>
#include <QtCore/qjsonvalue.h>
#include <QtCore/qstring.h>
 
QT_BEGIN_NAMESPACE
 
// Extracts key-value pairs from a JSON structure by finding an array with the given key.
// Recursively searches the JSON value for the array, then extracts all string key-value
// pairs from objects in that array. Handles both formats:
// 1. Array of single-key objects: [{"k1":"v1"},{"k2":"v2"}]
// 2. Array with multi-key object: [{"k1":"v1","k2":"v2"}]
QHash<QString, QString> extractKeyValuePairs(const QJsonValue &jval, const QString &arrayKey);
 
// Extracts key to string-list pairs from a JSON structure for plural translations.
// Expects format: [{"source1":["form1","form2"]},{"source2":["form1","form2"]}]
QHash<QString, QStringList> extractPluralTranslations(const QJsonValue &jval,
                                                      const QString &arrayKey);
 
// Returns the system prompt used for translation requests.
QString translationSystemPrompt();
 
// Returns the system prompt used for plural translation requests.
QString pluralTranslationSystemPrompt();
 
QT_END_NAMESPACE
 
#endif // TRANSLATIONUTILS_H