5#ifndef QQMLIRBUILDER_P_H
6#define QQMLIRBUILDER_P_H
19#include <private/qqmljsast_p.h>
20#include <private/qqmljsengine_p.h>
21#include <private/qv4compiler_p.h>
22#include <private/qv4compileddata_p.h>
23#include <private/qqmljsmemorypool_p.h>
24#include <private/qqmljsfixedpoolarray_p.h>
25#include <private/qv4codegen_p.h>
26#include <private/qv4compiler_p.h>
28#include <QCoreApplication>
32class QQmlPropertyCache;
34class QQmlTypeNameCache;
71 template <
typename Sortable,
typename Base, Sortable Base::*sortMember>
74 T *insertPos =
nullptr;
76 for (T *it =
first; it; it = it->next) {
77 if (!(it->*sortMember <= item->*sortMember))
86 if (!insertionPoint) {
88 }
else if (insertionPoint ==
last) {
91 item->next = insertionPoint->next;
92 insertionPoint->next = item;
98 T *
const newNext = item->next;
101 before->next = newNext;
119 while (index > 0 && result) {
120 result = result->next;
208 template<
typename IdGenerator>
210 QV4::CompiledData::ParameterType *type,
const IdGenerator &idGenerator,
211 const QQmlJS::AST::Type *annotation)
213 using Flag = QV4::CompiledData::ParameterType::Flag;
216 return initType(type, QString(), idGenerator(QString()), Flag::NoFlag);
218 const QString typeId = annotation->typeId->toString();
219 const QString typeArgument =
220 annotation->typeArgument ? annotation->typeArgument->toString() : QString();
222 if (typeArgument.isEmpty())
223 return initType(type, typeId, idGenerator(typeId), Flag::NoFlag);
225 if (typeId == QLatin1String(
"list"))
226 return initType(type, typeArgument, idGenerator(typeArgument), Flag::List);
228 const QString annotationString = annotation->toString();
229 return initType(type, annotationString, idGenerator(annotationString), Flag::NoFlag);
235 static bool initType(
236 QV4::CompiledData::ParameterType *paramType,
const QString &typeName,
237 int typeNameIndex, QV4::CompiledData::ParameterType::Flag listFlag);
315 Q_DECLARE_TR_FUNCTIONS(Object)
317 quint32 inheritedTypeNameIndex;
366 void init(QQmlJS::MemoryPool *pool,
int typeNameIndex,
int idIndex,
const QV4::CompiledData::Location &location);
370 QString appendProperty(Property *prop,
const QString &propertyName,
bool isDefaultProperty,
const QQmlJS::SourceLocation &defaultToken, QQmlJS::SourceLocation *errorLocation);
371 QString appendAlias(Alias *prop,
const QString &aliasName,
bool isDefaultProperty,
const QQmlJS::SourceLocation &defaultToken, QQmlJS::SourceLocation *errorLocation);
389 bool hasFlag(QV4::CompiledData::Object::Flag flag)
const {
return flags & flag; }
394 friend struct ::QQmlIRLoader;
396 PoolList<Property> *properties;
397 PoolList<Alias> *aliases;
398 PoolList<Enum> *qmlEnums;
399 PoolList<Signal> *qmlSignals;
400 PoolList<Binding> *bindings;
401 PoolList<Function> *functions;
402 PoolList<InlineComponent> *inlineComponents;
403 PoolList<RequiredPropertyExtraData> *requiredPropertyExtraDatas;
412 ListPropertyAssignBehavior,
414 FunctionSignatureBehavior,
415 NativeMethodBehavior,
420 enum ListPropertyAssignBehaviorValue
427 enum ComponentBehaviorValue
433 enum FunctionSignatureBehaviorValue
439 enum NativeMethodBehaviorValue
445 enum ValueTypeBehaviorValue
451 Q_DECLARE_FLAGS(ValueTypeBehaviorValues, ValueTypeBehaviorValue);
456 ListPropertyAssignBehaviorValue listPropertyAssignBehavior;
457 ComponentBehaviorValue componentBehavior;
458 FunctionSignatureBehaviorValue functionSignatureBehavior;
459 NativeMethodBehaviorValue nativeMethodBehavior;
460 ValueTypeBehaviorValues::Int valueTypeBehavior;
461 uint translationContextIndex;
464 QV4::CompiledData::Location location;
470 Q_DISABLE_COPY_MOVE(Document)
472 Document(
const QString &fileName,
const QString &finalUrl,
bool debugMode);
485 return std::any_of(pragmas.constBegin(), pragmas.constEnd(), [](
const Pragma *pragma) {
486 return pragma->type == Pragma::Singleton;
490 int registerString(
const QString &str) {
return jsGenerator.registerString(str); }
499 QmlIR::Document *document;
500 QQmlJS::Engine *engine;
501 QV4::Compiler::JSUnitGenerator *jsGenerator;
504 ScriptDirectivesCollector(QmlIR::Document *doc);
506 void pragmaLibrary() override;
507 void importFile(
const QString &jsfile,
const QString &module,
int lineNumber,
int column) override;
508 void importModule(
const QString &uri,
const QString &version,
const QString &module,
int lineNumber,
int column) override;
511struct Q_QML_COMPILER_EXPORT
IRBuilder :
public QQmlJS::AST::Visitor
513 Q_DECLARE_TR_FUNCTIONS(QQmlCodeGenerator)
516 bool generateFromQml(
const QString &code,
const QString &url, Document *output);
518 using QQmlJS::AST::Visitor::visit;
519 using QQmlJS::AST::Visitor::endVisit;
521 bool visit(QQmlJS::AST::UiImport *ast) override;
522 bool visit(QQmlJS::AST::UiPragma *ast) override;
523 bool visit(QQmlJS::AST::UiProgram *) override;
524 bool visit(QQmlJS::AST::UiArrayBinding *ast) override;
525 bool visit(QQmlJS::AST::UiObjectBinding *ast) override;
526 bool visit(QQmlJS::AST::UiObjectDefinition *ast) override;
527 bool visit(QQmlJS::AST::UiInlineComponent *ast) override;
528 bool visit(QQmlJS::AST::UiEnumDeclaration *ast) override;
529 bool visit(QQmlJS::AST::UiPublicMember *ast) override;
530 bool visit(QQmlJS::AST::UiScriptBinding *ast) override;
531 bool visit(QQmlJS::AST::UiSourceElement *ast) override;
532 bool visit(QQmlJS::AST::UiRequired *ast) override;
534 void throwRecursionDepthError() override
536 recordError(QQmlJS::SourceLocation(),
537 QStringLiteral(
"Maximum statement or expression depth exceeded"));
540 void accept(QQmlJS::AST::Node *node);
543 bool defineQMLObject(
544 int *objectIndex, QQmlJS::AST::UiQualifiedId *qualifiedTypeNameId,
545 const QV4::CompiledData::Location &location,
546 QQmlJS::AST::UiObjectInitializer *initializer, Object *declarationsOverride =
nullptr);
548 bool defineQMLObject(
549 int *objectIndex, QQmlJS::AST::UiObjectDefinition *node,
550 Object *declarationsOverride =
nullptr)
552 const QQmlJS::SourceLocation location = node->qualifiedTypeNameId->firstSourceLocation();
553 return defineQMLObject(
554 objectIndex, node->qualifiedTypeNameId,
555 { location.startLine, location.startColumn }, node->initializer,
556 declarationsOverride);
559 static QString asString(QQmlJS::AST::UiQualifiedId *node);
560 QStringView asStringRef(QQmlJS::AST::Node *node);
561 static QTypeRevision extractVersion(QStringView string);
562 QStringView textRefAt(
const QQmlJS::SourceLocation &loc)
const
563 {
return QStringView(sourceCode).mid(loc.offset, loc.length); }
564 QStringView textRefAt(
const QQmlJS::SourceLocation &first,
565 const QQmlJS::SourceLocation &last)
const;
567 virtual void setBindingValue(QV4::CompiledData::Binding *binding,
568 QQmlJS::AST::Statement *statement, QQmlJS::AST::Node *parentNode);
569 void tryGeneratingTranslationBinding(QStringView base, QQmlJS::AST::ArgumentList *args, QV4::CompiledData::Binding *binding);
571 void appendBinding(QQmlJS::AST::UiQualifiedId *name, QQmlJS::AST::Statement *value,
572 QQmlJS::AST::Node *parentNode);
573 void appendBinding(QQmlJS::AST::UiQualifiedId *name,
int objectIndex,
bool isOnAssignment =
false);
574 void appendBinding(
const QQmlJS::SourceLocation &qualifiedNameLocation,
575 const QQmlJS::SourceLocation &nameLocation, quint32 propertyNameIndex,
576 QQmlJS::AST::Statement *value, QQmlJS::AST::Node *parentNode);
577 void appendBinding(
const QQmlJS::SourceLocation &qualifiedNameLocation,
578 const QQmlJS::SourceLocation &nameLocation, quint32 propertyNameIndex,
579 int objectIndex,
bool isListItem =
false,
bool isOnAssignment =
false);
581 bool appendAlias(QQmlJS::AST::UiPublicMember *node);
583 enum class IsQmlFunction { Yes, No };
584 virtual void registerFunctionExpr(QQmlJS::AST::FunctionExpression *fexp, IsQmlFunction);
586 Object *bindingsTarget()
const;
588 bool setId(
const QQmlJS::SourceLocation &idLocation, QQmlJS::AST::Statement *value);
592 bool resolveQualifiedId(QQmlJS::AST::UiQualifiedId **nameToResolve, Object **object,
bool onAssignment =
false);
594 void recordError(
const QQmlJS::SourceLocation &location,
const QString &description);
596 quint32 registerString(
const QString &str)
const {
return jsGenerator->registerString(str); }
597 template <
typename _Tp> _Tp *New() {
return pool->New<_Tp>(); }
599 QString stringAt(
int index)
const {
return jsGenerator->stringForIndex(index); }
601 static bool isStatementNodeScript(QQmlJS::AST::Statement *statement);
602 static bool isRedundantNullInitializerForPropertyDeclaration(Property *property, QQmlJS::AST::Statement *statement);
604 QString sanityCheckFunctionNames(Object *obj, QQmlJS::SourceLocation *errorLocation);
606 QList<QQmlJS::DiagnosticMessage> errors;
608 QSet<QString> inlineComponentsNames;
610 QList<
const QV4::CompiledData::Import *> _imports;
611 QList<Pragma*> _pragmas;
612 QList<Object*> _objects;
614 QV4::CompiledData::TypeReferenceMap _typeReferences;
617 Property *_propertyDeclaration;
619 QQmlJS::MemoryPool *pool;
621 QV4::Compiler::JSUnitGenerator *jsGenerator;
623 bool insideInlineComponent =
false;
628 void generate(Document &output,
const QV4::CompiledData::DependentTypesHasher &dependencyHasher = QV4::CompiledData::DependentTypesHasher());
631 typedef bool (Binding::*BindingFilter)()
const;
632 char *writeBindings(
char *bindingPtr,
const Object *o, BindingFilter filter)
const;
635struct Q_QML_COMPILER_EXPORT
JSCodeGen :
public QV4::Compiler::Codegen
637 JSCodeGen(Document *document,
638 QV4::Compiler::CodegenWarningInterface *iface =
639 QV4::Compiler::defaultCodegenWarningInterface(),
640 bool storeSourceLocations =
false);
644 generateJSCodeForFunctionsAndBindings(
const QList<CompiledFunctionOrExpression> &functions);
646 bool generateRuntimeFunctions(QmlIR::Object *object);
655
656
657
658
659
660
661
662
663
664
666 typename RegisterMainString,
667 typename RegisterCommentString,
668 typename RegisterContextString,
669 typename FinalizeTranslationData>
671 RegisterMainString registerMainString,
672 RegisterCommentString registerCommentString,
673 RegisterContextString registerContextString,
674 FinalizeTranslationData finalizeTranslationData
677 if (base == QLatin1String(
"qsTr")) {
678 QV4::CompiledData::TranslationData translationData;
679 translationData.number = -1;
682 translationData.commentIndex = 0;
685 translationData.contextIndex = QV4::CompiledData::TranslationData::NoContextIndex;
687 if (!args || !args->expression)
690 QStringView translation;
691 if (QQmlJS::AST::StringLiteral *arg1 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression)) {
692 translation = arg1->value;
697 translationData.stringIndex = registerMainString(translation);
702 QQmlJS::AST::StringLiteral *arg2 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression);
705 translationData.commentIndex = registerCommentString(arg2->value);
709 if (QQmlJS::AST::NumericLiteral *arg3 = QQmlJS::AST::cast<QQmlJS::AST::NumericLiteral *>(args->expression)) {
710 translationData.number =
int(arg3->value);
721 finalizeTranslationData(QV4::CompiledData::Binding::Type_Translation, translationData);
722 }
else if (base == QLatin1String(
"qsTrId")) {
723 QV4::CompiledData::TranslationData translationData;
724 translationData.number = -1;
727 translationData.commentIndex = 0;
730 translationData.contextIndex = QV4::CompiledData::TranslationData::NoContextIndex;
732 if (!args || !args->expression)
736 if (QQmlJS::AST::StringLiteral *arg1 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression)) {
741 translationData.stringIndex = registerMainString(id);
746 if (QQmlJS::AST::NumericLiteral *arg3 = QQmlJS::AST::cast<QQmlJS::AST::NumericLiteral *>(args->expression)) {
747 translationData.number =
int(arg3->value);
757 finalizeTranslationData(QV4::CompiledData::Binding::Type_TranslationById, translationData);
758 }
else if (base == QLatin1String(
"QT_TR_NOOP") || base == QLatin1String(
"QT_TRID_NOOP")) {
759 if (!args || !args->expression)
763 if (QQmlJS::AST::StringLiteral *arg1 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression)) {
771 if (args && base == QLatin1String(
"QT_TR_NOOP")) {
773 if (QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression))
782 QV4::CompiledData::TranslationData translationData;
783 translationData.number = registerMainString(str);
784 finalizeTranslationData(QV4::CompiledData::Binding::Type_String, translationData);
785 }
else if (base == QLatin1String(
"QT_TRANSLATE_NOOP")) {
786 if (!args || !args->expression)
790 if (!args || !args->expression)
794 if (QQmlJS::AST::StringLiteral *arg2 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression)) {
803 if (QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression))
812 QV4::CompiledData::TranslationData fakeTranslationData;
813 fakeTranslationData.number = registerMainString(str);
814 finalizeTranslationData(QV4::CompiledData::Binding::Type_String, fakeTranslationData);
815 }
else if (base == QLatin1String(
"qsTranslate")) {
816 QV4::CompiledData::TranslationData translationData;
817 translationData.number = -1;
818 translationData.commentIndex = 0;
820 if (!args || !args->next)
823 QStringView translation;
824 if (QQmlJS::AST::StringLiteral *arg1
825 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression)) {
826 translation = arg1->value;
831 translationData.contextIndex = registerContextString(translation);
836 QQmlJS::AST::StringLiteral *arg2
837 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression);
840 translationData.stringIndex = registerMainString(arg2->value);
844 QQmlJS::AST::StringLiteral *arg3
845 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression);
848 translationData.commentIndex = registerCommentString(arg3->value);
852 if (QQmlJS::AST::NumericLiteral *arg4
853 = QQmlJS::AST::cast<QQmlJS::AST::NumericLiteral *>(args->expression)) {
854 translationData.number =
int(arg4->value);
865 finalizeTranslationData(QV4::CompiledData::Binding::Type_Translation, translationData);
void tryGeneratingTranslationBindingBase(QStringView base, QQmlJS::AST::ArgumentList *args, RegisterMainString registerMainString, RegisterCommentString registerCommentString, RegisterContextString registerContextString, FinalizeTranslationData finalizeTranslationData)
static const quint32 emptyStringIndex
#define COMPILE_EXCEPTION(location, desc)
static QStringList astNodeToStringList(QQmlJS::AST::Node *node)
static bool run(IRBuilder *builder, QQmlJS::AST::UiPragma *node, Pragma *pragma)
CompiledFunctionOrExpression * next
QQmlRefPointer< QV4::CompiledData::CompilationUnit > javaScriptCompilationUnit
Object * objectAt(int i) const
QQmlJS::AST::UiProgram * program
QString stringAt(int index) const
QV4::Compiler::Module jsModule
QV4::Compiler::JSUnitGenerator jsGenerator
int registerString(const QString &str)
QList< Pragma * > pragmas
QList< const QV4::CompiledData::Import * > imports
QQmlJS::Engine jsParserEngine
QList< Object * > objects
QV4::CompiledData::Location location
PoolList< EnumValue >::Iterator enumValuesEnd() const
PoolList< EnumValue > * enumValues
int enumValueCount() const
PoolList< EnumValue >::Iterator enumValuesBegin() const
QV4::CompiledData::Location location
const Parameter * formalsBegin() const
QV4::CompiledData::ParameterType returnType
QQmlJS::FixedPoolArray< Parameter > formals
const Parameter * formalsEnd() const
bool hasFlag(QV4::CompiledData::Object::Flag flag) const
int indexOfDefaultPropertyOrAlias
PoolList< Property >::Iterator propertiesEnd() const
PoolList< Property >::Iterator propertiesBegin() const
int requiredPropertyExtraDataCount() const
QString appendEnum(Enum *enumeration)
PoolList< Signal >::Iterator signalsEnd() const
int inlineComponentCount() const
const quint32 * namedObjectsInComponentTable() const
void appendRequiredPropertyExtraData(RequiredPropertyExtraData *extraData)
PoolList< RequiredPropertyExtraData >::Iterator requiredPropertyExtraDataEnd() const
void insertSorted(Binding *b)
PoolList< Binding >::Iterator bindingsEnd() const
PoolList< Function >::Iterator functionsBegin() const
void simplifyRequiredProperties()
QString appendBinding(Binding *b, bool isListBinding)
QV4::CompiledData::Location location
void appendInlineComponent(InlineComponent *ic)
bool defaultPropertyIsAlias
Alias * firstAlias() const
PoolList< Function >::Iterator functionsEnd() const
PoolList< Alias >::Iterator aliasesBegin() const
PoolList< RequiredPropertyExtraData >::Iterator requiredPropertyExtraDataBegin() const
PoolList< Enum >::Iterator enumsEnd() const
QString appendSignal(Signal *signal)
Binding * firstBinding() const
const Property * firstProperty() const
QString bindingAsString(Document *doc, int scriptIndex) const
const Enum * firstEnum() const
void init(QQmlJS::MemoryPool *pool, int typeNameIndex, int idIndex, const QV4::CompiledData::Location &location)
Object * declarationsOverride
QString appendAlias(Alias *prop, const QString &aliasName, bool isDefaultProperty, const QQmlJS::SourceLocation &defaultToken, QQmlJS::SourceLocation *errorLocation)
int functionCount() const
QString appendProperty(Property *prop, const QString &propertyName, bool isDefaultProperty, const QQmlJS::SourceLocation &defaultToken, QQmlJS::SourceLocation *errorLocation)
PoolList< Enum >::Iterator enumsBegin() const
PoolList< CompiledFunctionOrExpression > * functionsAndExpressions
Binding * unlinkBinding(Binding *before, Binding *binding)
const RequiredPropertyExtraData * requiredPropertyExtraData() const
bool hasAliasAsDefaultProperty() const
PoolList< InlineComponent >::Iterator inlineComponentsEnd() const
PoolList< Signal >::Iterator signalsBegin() const
void appendFunction(QmlIR::Function *f)
const Function * firstFunction() const
PoolList< Binding >::Iterator bindingsBegin() const
PoolList< InlineComponent >::Iterator inlineComponentsBegin() const
const InlineComponent * inlineComponent() const
QQmlJS::FixedPoolArray< int > runtimeFunctionIndices
const Signal * firstSignal() const
QV4::CompiledData::Location locationOfIdProperty
QQmlJS::FixedPoolArray< quint32 > namedObjectsInComponent
Binding * findBinding(quint32 nameIndex) const
int propertyCount() const
int namedObjectsInComponentCount() const
PoolList< Alias >::Iterator aliasesEnd() const
static bool initType(QV4::CompiledData::ParameterType *type, const IdGenerator &idGenerator, const QQmlJS::AST::Type *annotation)
static QV4::CompiledData::CommonType stringToBuiltinType(const QString &typeName)
operator const T *() const
bool operator!=(const Iterator &rhs) const
const T * operator->() const
bool operator==(const Iterator &rhs) const
const T & operator*() const
T * findSortedInsertionPoint(T *item) const
T * unlink(T *before, T *item)
T * slowAt(int index) const
void insertAfter(T *insertionPoint, T *item)
int parameterCount() const
PoolList< Parameter > * parameters
PoolList< Parameter >::Iterator parametersEnd() const
QStringList parameterStringList(const QV4::Compiler::StringTableGenerator *stringPool) const
PoolList< Parameter >::Iterator parametersBegin() const
QV4::CompiledData::Location location