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;
73 T *
const newNext = item->next;
76 before->next = newNext;
94 while (index > 0 && result) {
95 result = result->next;
183 template<
typename IdGenerator>
185 QV4::CompiledData::ParameterType *type,
const IdGenerator &idGenerator,
186 const QQmlJS::AST::Type *annotation)
188 using Flag = QV4::CompiledData::ParameterType::Flag;
191 return initType(type, QString(), idGenerator(QString()), Flag::NoFlag);
193 const QString typeId = annotation->typeId->toString();
194 const QString typeArgument =
195 annotation->typeArgument ? annotation->typeArgument->toString() : QString();
197 if (typeArgument.isEmpty())
198 return initType(type, typeId, idGenerator(typeId), Flag::NoFlag);
200 if (typeId == QLatin1String(
"list"))
201 return initType(type, typeArgument, idGenerator(typeArgument), Flag::List);
203 const QString annotationString = annotation->toString();
204 return initType(type, annotationString, idGenerator(annotationString), Flag::NoFlag);
210 static bool initType(
211 QV4::CompiledData::ParameterType *paramType,
const QString &typeName,
212 int typeNameIndex, QV4::CompiledData::ParameterType::Flag listFlag);
250 if (source.isEmpty() || !source.front().isUpper())
255 for (
const QChar c : source) {
256 if (!(c.isLetterOrNumber() || c == u'.' || c == u'_' || c.isSpace()))
260 const qsizetype dot = source.indexOf(u'.');
261 return (dot == -1 || dot == source.size() - 1) ? -1 : dot;
309 Q_DECLARE_TR_FUNCTIONS(Object)
311 quint32 inheritedTypeNameIndex;
361 void init(QQmlJS::MemoryPool *pool,
int typeNameIndex,
int idIndex,
const QV4::CompiledData::Location &location);
365 QString appendProperty(Property *prop,
const QString &propertyName,
bool isDefaultProperty,
const QQmlJS::SourceLocation &defaultToken, QQmlJS::SourceLocation *errorLocation);
366 QString appendAlias(Alias *prop,
const QString &aliasName,
bool isDefaultProperty,
const QQmlJS::SourceLocation &defaultToken, QQmlJS::SourceLocation *errorLocation);
385 bool hasFlag(QV4::CompiledData::Object::Flag flag)
const {
return flags & flag; }
390 friend struct ::QQmlIRLoader;
392 PoolList<Property> *properties;
393 PoolList<Alias> *aliases;
394 PoolList<Enum> *qmlEnums;
395 PoolList<Signal> *qmlSignals;
396 PoolList<Binding> *bindings;
397 PoolList<Function> *functions;
398 PoolList<InlineComponent> *inlineComponents;
399 PoolList<RequiredPropertyExtraData> *requiredPropertyExtraDatas;
408 ListPropertyAssignBehavior,
410 FunctionSignatureBehavior,
411 NativeMethodBehavior,
416 enum ListPropertyAssignBehaviorValue
423 enum ComponentBehaviorValue
429 enum FunctionSignatureBehaviorValue
435 enum NativeMethodBehaviorValue
441 enum ValueTypeBehaviorValue
447 Q_DECLARE_FLAGS(ValueTypeBehaviorValues, ValueTypeBehaviorValue);
452 ListPropertyAssignBehaviorValue listPropertyAssignBehavior;
453 ComponentBehaviorValue componentBehavior;
454 FunctionSignatureBehaviorValue functionSignatureBehavior;
455 NativeMethodBehaviorValue nativeMethodBehavior;
456 ValueTypeBehaviorValues::Int valueTypeBehavior;
457 uint translationContextIndex;
460 QV4::CompiledData::Location location;
466 Q_DISABLE_COPY_MOVE(Document)
468 Document(
const QString &fileName,
const QString &finalUrl,
bool debugMode);
481 return std::any_of(pragmas.constBegin(), pragmas.constEnd(), [](
const Pragma *pragma) {
482 return pragma->type == Pragma::Singleton;
486 int registerString(
const QString &str) {
return jsGenerator.registerString(str); }
495 QmlIR::Document *document;
496 QQmlJS::Engine *engine;
497 QV4::Compiler::JSUnitGenerator *jsGenerator;
500 ScriptDirectivesCollector(QmlIR::Document *doc);
502 void pragmaLibrary() override;
503 void importFile(
const QString &jsfile,
const QString &module,
int lineNumber,
int column) override;
504 void importModule(
const QString &uri,
const QString &version,
const QString &module,
int lineNumber,
int column) override;
507struct Q_QML_COMPILER_EXPORT
IRBuilder :
public QQmlJS::AST::Visitor
509 Q_DECLARE_TR_FUNCTIONS(QQmlCodeGenerator)
512 bool generateFromQml(
const QString &code,
const QString &url, Document *output);
514 using QQmlJS::AST::Visitor::visit;
515 using QQmlJS::AST::Visitor::endVisit;
517 bool visit(QQmlJS::AST::UiImport *ast) override;
518 bool visit(QQmlJS::AST::UiPragma *ast) override;
519 bool visit(QQmlJS::AST::UiProgram *) override;
520 bool visit(QQmlJS::AST::UiArrayBinding *ast) override;
521 bool visit(QQmlJS::AST::UiObjectBinding *ast) override;
522 bool visit(QQmlJS::AST::UiObjectDefinition *ast) override;
523 bool visit(QQmlJS::AST::UiInlineComponent *ast) override;
524 bool visit(QQmlJS::AST::UiEnumDeclaration *ast) override;
525 bool visit(QQmlJS::AST::UiPublicMember *ast) override;
526 bool visit(QQmlJS::AST::UiScriptBinding *ast) override;
527 bool visit(QQmlJS::AST::UiSourceElement *ast) override;
528 bool visit(QQmlJS::AST::UiRequired *ast) override;
530 void throwRecursionDepthError() override
532 recordError(QQmlJS::SourceLocation(),
533 QStringLiteral(
"Maximum statement or expression depth exceeded"));
536 void accept(QQmlJS::AST::Node *node);
539 bool defineQMLObject(
540 int *objectIndex, QQmlJS::AST::UiQualifiedId *qualifiedTypeNameId,
541 const QV4::CompiledData::Location &location,
542 QQmlJS::AST::UiObjectInitializer *initializer, Object *declarationsOverride =
nullptr);
544 bool defineQMLObject(
545 int *objectIndex, QQmlJS::AST::UiObjectDefinition *node,
546 Object *declarationsOverride =
nullptr)
548 const QQmlJS::SourceLocation location = node->qualifiedTypeNameId->firstSourceLocation();
549 return defineQMLObject(
550 objectIndex, node->qualifiedTypeNameId,
551 { location.startLine, location.startColumn }, node->initializer,
552 declarationsOverride);
555 static QString asString(QQmlJS::AST::UiQualifiedId *node);
556 QStringView asStringRef(QQmlJS::AST::Node *node);
557 static QTypeRevision extractVersion(QStringView string);
558 QStringView textRefAt(
const QQmlJS::SourceLocation &loc)
const
559 {
return QStringView(sourceCode).mid(loc.offset, loc.length); }
560 QStringView textRefAt(
const QQmlJS::SourceLocation &first,
561 const QQmlJS::SourceLocation &last)
const;
563 virtual void setBindingValue(QV4::CompiledData::Binding *binding,
564 QQmlJS::AST::Statement *statement, QQmlJS::AST::Node *parentNode);
565 void tryGeneratingTranslationBinding(QStringView base, QQmlJS::AST::ArgumentList *args, QV4::CompiledData::Binding *binding);
567 void appendBinding(QQmlJS::AST::UiQualifiedId *name, QQmlJS::AST::Statement *value,
568 QQmlJS::AST::Node *parentNode);
569 void appendBinding(QQmlJS::AST::UiQualifiedId *name,
int objectIndex,
bool isOnAssignment =
false);
570 void appendBinding(
const QQmlJS::SourceLocation &qualifiedNameLocation,
571 const QQmlJS::SourceLocation &nameLocation, quint32 propertyNameIndex,
572 QQmlJS::AST::Statement *value, QQmlJS::AST::Node *parentNode);
573 void appendBinding(
const QQmlJS::SourceLocation &qualifiedNameLocation,
574 const QQmlJS::SourceLocation &nameLocation, quint32 propertyNameIndex,
575 int objectIndex,
bool isListItem =
false,
bool isOnAssignment =
false);
577 bool appendAlias(QQmlJS::AST::UiPublicMember *node);
579 enum class IsQmlFunction { Yes, No };
580 virtual void registerFunctionExpr(QQmlJS::AST::FunctionExpression *fexp, IsQmlFunction);
582 Object *bindingsTarget()
const;
584 bool setId(
const QQmlJS::SourceLocation &idLocation, QQmlJS::AST::Statement *value);
588 bool resolveQualifiedId(QQmlJS::AST::UiQualifiedId **nameToResolve, Object **object,
bool onAssignment =
false);
590 void recordError(
const QQmlJS::SourceLocation &location,
const QString &description);
592 quint32 registerString(
const QString &str)
const {
return jsGenerator->registerString(str); }
593 template <
typename _Tp> _Tp *New() {
return pool->New<_Tp>(); }
595 QString stringAt(
int index)
const {
return jsGenerator->stringForIndex(index); }
597 static bool isStatementNodeScript(QQmlJS::AST::Statement *statement);
598 static bool isRedundantNullInitializerForPropertyDeclaration(Property *property, QQmlJS::AST::Statement *statement);
600 QString sanityCheckFunctionNames(Object *obj, QQmlJS::SourceLocation *errorLocation);
602 QList<QQmlJS::DiagnosticMessage> errors;
604 QSet<QString> inlineComponentsNames;
606 QList<
const QV4::CompiledData::Import *> _imports;
607 QList<Pragma*> _pragmas;
608 QList<Object*> _objects;
610 QV4::CompiledData::TypeReferenceMap _typeReferences;
613 Property *_propertyDeclaration;
615 QQmlJS::MemoryPool *pool;
617 QV4::Compiler::JSUnitGenerator *jsGenerator;
619 bool insideInlineComponent =
false;
624 void generate(Document &output,
const QV4::CompiledData::DependentTypesHasher &dependencyHasher = QV4::CompiledData::DependentTypesHasher());
627 typedef bool (Binding::*BindingFilter)()
const;
628 char *writeBindings(
char *bindingPtr,
const Object *o, BindingFilter filter)
const;
631struct Q_QML_COMPILER_EXPORT
JSCodeGen :
public QV4::Compiler::Codegen
633 JSCodeGen(Document *document,
634 QV4::Compiler::CodegenWarningInterface *iface =
635 QV4::Compiler::defaultCodegenWarningInterface(),
636 bool storeSourceLocations =
false);
640 generateJSCodeForFunctionsAndBindings(
const QList<CompiledFunctionOrExpression> &functions);
642 bool generateRuntimeFunctions(QmlIR::Object *object);
651
652
653
654
655
656
657
658
659
660
662 typename RegisterMainString,
663 typename RegisterCommentString,
664 typename RegisterContextString,
665 typename FinalizeTranslationData>
667 RegisterMainString registerMainString,
668 RegisterCommentString registerCommentString,
669 RegisterContextString registerContextString,
670 FinalizeTranslationData finalizeTranslationData
673 if (base == QLatin1String(
"qsTr")) {
674 QV4::CompiledData::TranslationData translationData;
675 translationData.number = -1;
678 translationData.commentIndex = 0;
681 translationData.contextIndex = QV4::CompiledData::TranslationData::NoContextIndex;
683 if (!args || !args->expression)
686 QStringView translation;
687 if (QQmlJS::AST::StringLiteral *arg1 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression)) {
688 translation = arg1->value;
693 translationData.stringIndex = registerMainString(translation);
698 QQmlJS::AST::StringLiteral *arg2 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression);
701 translationData.commentIndex = registerCommentString(arg2->value);
705 if (QQmlJS::AST::NumericLiteral *arg3 = QQmlJS::AST::cast<QQmlJS::AST::NumericLiteral *>(args->expression)) {
706 translationData.number =
int(arg3->value);
717 finalizeTranslationData(QV4::CompiledData::Binding::Type_Translation, translationData);
718 }
else if (base == QLatin1String(
"qsTrId")) {
719 QV4::CompiledData::TranslationData translationData;
720 translationData.number = -1;
723 translationData.commentIndex = 0;
726 translationData.contextIndex = QV4::CompiledData::TranslationData::NoContextIndex;
728 if (!args || !args->expression)
732 if (QQmlJS::AST::StringLiteral *arg1 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression)) {
737 translationData.stringIndex = registerMainString(id);
742 if (QQmlJS::AST::NumericLiteral *arg3 = QQmlJS::AST::cast<QQmlJS::AST::NumericLiteral *>(args->expression)) {
743 translationData.number =
int(arg3->value);
753 finalizeTranslationData(QV4::CompiledData::Binding::Type_TranslationById, translationData);
754 }
else if (base == QLatin1String(
"QT_TR_NOOP") || base == QLatin1String(
"QT_TRID_NOOP")) {
755 if (!args || !args->expression)
759 if (QQmlJS::AST::StringLiteral *arg1 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression)) {
767 if (args && base == QLatin1String(
"QT_TR_NOOP")) {
769 if (QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression))
778 QV4::CompiledData::TranslationData translationData;
779 translationData.number = registerMainString(str);
780 finalizeTranslationData(QV4::CompiledData::Binding::Type_String, translationData);
781 }
else if (base == QLatin1String(
"QT_TRANSLATE_NOOP")) {
782 if (!args || !args->expression)
786 if (!args || !args->expression)
790 if (QQmlJS::AST::StringLiteral *arg2 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression)) {
799 if (QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression))
808 QV4::CompiledData::TranslationData fakeTranslationData;
809 fakeTranslationData.number = registerMainString(str);
810 finalizeTranslationData(QV4::CompiledData::Binding::Type_String, fakeTranslationData);
811 }
else if (base == QLatin1String(
"qsTranslate")) {
812 QV4::CompiledData::TranslationData translationData;
813 translationData.number = -1;
814 translationData.commentIndex = 0;
816 if (!args || !args->next)
819 QStringView translation;
820 if (QQmlJS::AST::StringLiteral *arg1
821 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression)) {
822 translation = arg1->value;
827 translationData.contextIndex = registerContextString(translation);
832 QQmlJS::AST::StringLiteral *arg2
833 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression);
836 translationData.stringIndex = registerMainString(arg2->value);
840 QQmlJS::AST::StringLiteral *arg3
841 = QQmlJS::AST::cast<QQmlJS::AST::StringLiteral *>(args->expression);
844 translationData.commentIndex = registerCommentString(arg3->value);
848 if (QQmlJS::AST::NumericLiteral *arg4
849 = QQmlJS::AST::cast<QQmlJS::AST::NumericLiteral *>(args->expression)) {
850 translationData.number =
int(arg4->value);
861 finalizeTranslationData(QV4::CompiledData::Binding::Type_Translation, translationData);
int qualifiedEnumDot(QStringView source)
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
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 * unlink(T *before, T *item)
T * slowAt(int index) const
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