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;
367 void init(QQmlJS::MemoryPool *pool,
int typeNameIndex,
int idIndex,
const QV4::CompiledData::Location &location);
371 QString appendProperty(Property *prop,
const QString &propertyName,
bool isDefaultProperty,
const QQmlJS::SourceLocation &defaultToken, QQmlJS::SourceLocation *errorLocation);
372 QString appendAlias(Alias *prop,
const QString &aliasName,
bool isDefaultProperty,
const QQmlJS::SourceLocation &defaultToken, QQmlJS::SourceLocation *errorLocation);
392 bool hasFlag(QV4::CompiledData::Object::Flag flag)
const {
return flags & flag; }
397 friend struct ::QQmlIRLoader;
399 PoolList<Property> *properties;
400 PoolList<Alias> *aliases;
401 PoolList<Enum> *qmlEnums;
402 PoolList<Signal> *qmlSignals;
403 PoolList<Binding> *bindings;
404 PoolList<Function> *functions;
405 PoolList<InlineComponent> *inlineComponents;
406 PoolList<RequiredPropertyExtraData> *requiredPropertyExtraDatas;
415 ListPropertyAssignBehavior,
417 FunctionSignatureBehavior,
418 NativeMethodBehavior,
423 enum ListPropertyAssignBehaviorValue
430 enum ComponentBehaviorValue
436 enum FunctionSignatureBehaviorValue
442 enum NativeMethodBehaviorValue
448 enum ValueTypeBehaviorValue
454 Q_DECLARE_FLAGS(ValueTypeBehaviorValues, ValueTypeBehaviorValue);
459 ListPropertyAssignBehaviorValue listPropertyAssignBehavior;
460 ComponentBehaviorValue componentBehavior;
461 FunctionSignatureBehaviorValue functionSignatureBehavior;
462 NativeMethodBehaviorValue nativeMethodBehavior;
463 ValueTypeBehaviorValues::Int valueTypeBehavior;
464 uint translationContextIndex;
467 QV4::CompiledData::Location location;
473 Q_DISABLE_COPY_MOVE(Document)
475 Document(
const QString &fileName,
const QString &finalUrl,
bool debugMode);
488 return std::any_of(pragmas.constBegin(), pragmas.constEnd(), [](
const Pragma *pragma) {
489 return pragma->type == Pragma::Singleton;
493 int registerString(
const QString &str) {
return jsGenerator.registerString(str); }
502 QmlIR::Document *document;
503 QQmlJS::Engine *engine;
504 QV4::Compiler::JSUnitGenerator *jsGenerator;
507 ScriptDirectivesCollector(QmlIR::Document *doc);
509 void pragmaLibrary() override;
510 void importFile(
const QString &jsfile,
const QString &module,
int lineNumber,
int column) override;
511 void importModule(
const QString &uri,
const QString &version,
const QString &module,
int lineNumber,
int column) override;
514struct Q_QML_COMPILER_EXPORT
IRBuilder :
public QQmlJS::AST::Visitor
516 Q_DECLARE_TR_FUNCTIONS(QQmlCodeGenerator)
519 bool generateFromQml(
const QString &code,
const QString &url, Document *output);
521 using QQmlJS::AST::Visitor::visit;
522 using QQmlJS::AST::Visitor::endVisit;
524 bool visit(QQmlJS::AST::UiImport *ast) override;
525 bool visit(QQmlJS::AST::UiPragma *ast) override;
526 bool visit(QQmlJS::AST::UiProgram *) override;
527 bool visit(QQmlJS::AST::UiArrayBinding *ast) override;
528 bool visit(QQmlJS::AST::UiObjectBinding *ast) override;
529 bool visit(QQmlJS::AST::UiObjectDefinition *ast) override;
530 bool visit(QQmlJS::AST::UiInlineComponent *ast) override;
531 bool visit(QQmlJS::AST::UiEnumDeclaration *ast) override;
532 bool visit(QQmlJS::AST::UiPublicMember *ast) override;
533 bool visit(QQmlJS::AST::UiScriptBinding *ast) override;
534 bool visit(QQmlJS::AST::UiSourceElement *ast) override;
535 bool visit(QQmlJS::AST::UiRequired *ast) override;
537 void throwRecursionDepthError() override
539 recordError(QQmlJS::SourceLocation(),
540 QStringLiteral(
"Maximum statement or expression depth exceeded"));
543 void accept(QQmlJS::AST::Node *node);
546 bool defineQMLObject(
547 int *objectIndex, QQmlJS::AST::UiQualifiedId *qualifiedTypeNameId,
548 const QV4::CompiledData::Location &location,
549 QQmlJS::AST::UiObjectInitializer *initializer, Object *declarationsOverride =
nullptr);
551 bool defineQMLObject(
552 int *objectIndex, QQmlJS::AST::UiObjectDefinition *node,
553 Object *declarationsOverride =
nullptr)
555 const QQmlJS::SourceLocation location = node->qualifiedTypeNameId->firstSourceLocation();
556 return defineQMLObject(
557 objectIndex, node->qualifiedTypeNameId,
558 { location.startLine, location.startColumn }, node->initializer,
559 declarationsOverride);
562 static QString asString(QQmlJS::AST::UiQualifiedId *node);
563 QStringView asStringRef(QQmlJS::AST::Node *node);
564 static QTypeRevision extractVersion(QStringView string);
565 QStringView textRefAt(
const QQmlJS::SourceLocation &loc)
const
566 {
return QStringView(sourceCode).mid(loc.offset, loc.length); }
567 QStringView textRefAt(
const QQmlJS::SourceLocation &first,
568 const QQmlJS::SourceLocation &last)
const;
570 virtual void setBindingValue(QV4::CompiledData::Binding *binding,
571 QQmlJS::AST::Statement *statement, QQmlJS::AST::Node *parentNode);
572 void tryGeneratingTranslationBinding(QStringView base, QQmlJS::AST::ArgumentList *args, QV4::CompiledData::Binding *binding);
574 void appendBinding(QQmlJS::AST::UiQualifiedId *name, QQmlJS::AST::Statement *value,
575 QQmlJS::AST::Node *parentNode);
576 void appendBinding(QQmlJS::AST::UiQualifiedId *name,
int objectIndex,
bool isOnAssignment =
false);
577 void appendBinding(
const QQmlJS::SourceLocation &qualifiedNameLocation,
578 const QQmlJS::SourceLocation &nameLocation, quint32 propertyNameIndex,
579 QQmlJS::AST::Statement *value, QQmlJS::AST::Node *parentNode);
580 void appendBinding(
const QQmlJS::SourceLocation &qualifiedNameLocation,
581 const QQmlJS::SourceLocation &nameLocation, quint32 propertyNameIndex,
582 int objectIndex,
bool isListItem =
false,
bool isOnAssignment =
false);
584 bool appendAlias(QQmlJS::AST::UiPublicMember *node);
586 enum class IsQmlFunction { Yes, No };
587 virtual void registerFunctionExpr(QQmlJS::AST::FunctionExpression *fexp, IsQmlFunction);
589 Object *bindingsTarget()
const;
591 bool setId(
const QQmlJS::SourceLocation &idLocation, QQmlJS::AST::Statement *value);
595 bool resolveQualifiedId(QQmlJS::AST::UiQualifiedId **nameToResolve, Object **object,
bool onAssignment =
false);
597 void recordError(
const QQmlJS::SourceLocation &location,
const QString &description);
599 quint32 registerString(
const QString &str)
const {
return jsGenerator->registerString(str); }
600 template <
typename _Tp> _Tp *New() {
return pool->New<_Tp>(); }
602 QString stringAt(
int index)
const {
return jsGenerator->stringForIndex(index); }
604 static bool isStatementNodeScript(QQmlJS::AST::Statement *statement);
605 static bool isRedundantNullInitializerForPropertyDeclaration(Property *property, QQmlJS::AST::Statement *statement);
607 QString sanityCheckFunctionNames(Object *obj, QQmlJS::SourceLocation *errorLocation);
609 QList<QQmlJS::DiagnosticMessage> errors;
611 QSet<QString> inlineComponentsNames;
613 QList<
const QV4::CompiledData::Import *> _imports;
614 QList<Pragma*> _pragmas;
615 QList<Object*> _objects;
617 QV4::CompiledData::TypeReferenceMap _typeReferences;
620 Property *_propertyDeclaration;
622 QQmlJS::MemoryPool *pool;
624 QV4::Compiler::JSUnitGenerator *jsGenerator;
626 bool insideInlineComponent =
false;
631 void generate(Document &output,
const QV4::CompiledData::DependentTypesHasher &dependencyHasher = QV4::CompiledData::DependentTypesHasher());
634 typedef bool (Binding::*BindingFilter)()
const;
635 char *writeBindings(
char *bindingPtr,
const Object *o, BindingFilter filter)
const;
638struct Q_QML_COMPILER_EXPORT
JSCodeGen :
public QV4::Compiler::Codegen
640 JSCodeGen(Document *document,
641 QV4::Compiler::CodegenWarningInterface *iface =
642 QV4::Compiler::defaultCodegenWarningInterface(),
643 bool storeSourceLocations =
false);
647 generateJSCodeForFunctionsAndBindings(
const QList<CompiledFunctionOrExpression> &functions);
649 bool generateRuntimeFunctions(QmlIR::Object *object);
658
659
660
661
662
663
664
665
666
667
669 typename RegisterMainString,
670 typename RegisterCommentString,
671 typename RegisterContextString,
672 typename FinalizeTranslationData>
674 RegisterMainString registerMainString,
675 RegisterCommentString registerCommentString,
676 RegisterContextString registerContextString,
677 FinalizeTranslationData finalizeTranslationData
680 if (base == QLatin1String(
"qsTr")) {
681 QV4::CompiledData::TranslationData translationData;
682 translationData.number = -1;
685 translationData.commentIndex = 0;
688 translationData.contextIndex = QV4::CompiledData::TranslationData::NoContextIndex;
690 if (!args || !args->expression)
693 QStringView translation;
694 if (QQmlJS::AST::StringLiteral *arg1 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression)) {
695 translation = arg1->value;
700 translationData.stringIndex = registerMainString(translation);
705 QQmlJS::AST::StringLiteral *arg2 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression);
708 translationData.commentIndex = registerCommentString(arg2->value);
712 if (QQmlJS::AST::NumericLiteral *arg3 = QQmlJS::AST::cast<QQmlJS::AST::NumericLiteral *>(args->expression)) {
713 translationData.number =
int(arg3->value);
724 finalizeTranslationData(QV4::CompiledData::Binding::Type_Translation, translationData);
725 }
else if (base == QLatin1String(
"qsTrId")) {
726 QV4::CompiledData::TranslationData translationData;
727 translationData.number = -1;
730 translationData.commentIndex = 0;
733 translationData.contextIndex = QV4::CompiledData::TranslationData::NoContextIndex;
735 if (!args || !args->expression)
739 if (QQmlJS::AST::StringLiteral *arg1 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression)) {
744 translationData.stringIndex = registerMainString(id);
749 if (QQmlJS::AST::NumericLiteral *arg3 = QQmlJS::AST::cast<QQmlJS::AST::NumericLiteral *>(args->expression)) {
750 translationData.number =
int(arg3->value);
760 finalizeTranslationData(QV4::CompiledData::Binding::Type_TranslationById, translationData);
761 }
else if (base == QLatin1String(
"QT_TR_NOOP") || base == QLatin1String(
"QT_TRID_NOOP")) {
762 if (!args || !args->expression)
766 if (QQmlJS::AST::StringLiteral *arg1 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression)) {
774 if (args && base == QLatin1String(
"QT_TR_NOOP")) {
776 if (QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression))
785 QV4::CompiledData::TranslationData translationData;
786 translationData.number = registerMainString(str);
787 finalizeTranslationData(QV4::CompiledData::Binding::Type_String, translationData);
788 }
else if (base == QLatin1String(
"QT_TRANSLATE_NOOP")) {
789 if (!args || !args->expression)
793 if (!args || !args->expression)
797 if (QQmlJS::AST::StringLiteral *arg2 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression)) {
806 if (QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression))
815 QV4::CompiledData::TranslationData fakeTranslationData;
816 fakeTranslationData.number = registerMainString(str);
817 finalizeTranslationData(QV4::CompiledData::Binding::Type_String, fakeTranslationData);
818 }
else if (base == QLatin1String(
"qsTranslate")) {
819 QV4::CompiledData::TranslationData translationData;
820 translationData.number = -1;
821 translationData.commentIndex = 0;
823 if (!args || !args->next)
826 QStringView translation;
827 if (QQmlJS::AST::StringLiteral *arg1
828 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression)) {
829 translation = arg1->value;
834 translationData.contextIndex = registerContextString(translation);
839 QQmlJS::AST::StringLiteral *arg2
840 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression);
843 translationData.stringIndex = registerMainString(arg2->value);
847 QQmlJS::AST::StringLiteral *arg3
848 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression);
851 translationData.commentIndex = registerCommentString(arg3->value);
855 if (QQmlJS::AST::NumericLiteral *arg4
856 = QQmlJS::AST::cast<QQmlJS::AST::NumericLiteral *>(args->expression)) {
857 translationData.number =
int(arg4->value);
868 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 setFirstAlias(Alias *alias)
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)
void sortAliasDependencies(const Document *doc, QList< QQmlJS::DiagnosticMessage > *errors)
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