// This file is part of the Luau programming language and is licensed under MIT License; see LICENSE.txt for details #pragma once #include "Luau/Location.h" #include "Luau/NotNull.h" #include "Luau/Type.h" #include "Luau/Variant.h" #include "Luau/Ast.h" #include namespace Luau { struct FileResolver; struct TypeArena; struct TypeError; struct TypeMismatch { enum Context { CovariantContext, InvariantContext }; TypeMismatch() = default; TypeMismatch(TypeId wantedType, TypeId givenType); TypeMismatch(TypeId wantedType, TypeId givenType, std::string reason); TypeMismatch(TypeId wantedType, TypeId givenType, std::string reason, std::optional error); TypeMismatch(TypeId wantedType, TypeId givenType, Context context); TypeMismatch(TypeId wantedType, TypeId givenType, std::string reason, Context context); TypeMismatch(TypeId wantedType, TypeId givenType, std::string reason, std::optional error, Context context); TypeId wantedType = nullptr; TypeId givenType = nullptr; Context context = CovariantContext; std::string reason; std::shared_ptr error; bool operator==(const TypeMismatch& rhs) const; }; struct UnknownSymbol { enum Context { Binding, Type, }; Name name; Context context; bool operator==(const UnknownSymbol& rhs) const; }; struct UnknownProperty { TypeId table; Name key; bool operator==(const UnknownProperty& rhs) const; }; struct NotATable { TypeId ty; bool operator==(const NotATable& rhs) const; }; struct CannotExtendTable { enum Context { Property, Indexer, Metatable }; TypeId tableType; Context context; Name prop; bool operator==(const CannotExtendTable& rhs) const; }; struct OnlyTablesCanHaveMethods { TypeId tableType; bool operator==(const OnlyTablesCanHaveMethods& rhs) const; }; struct DuplicateTypeDefinition { Name name; std::optional previousLocation; bool operator==(const DuplicateTypeDefinition& rhs) const; }; struct CountMismatch { enum Context { Arg, FunctionResult, ExprListResult, Return, }; size_t expected; std::optional maximum; size_t actual; Context context = Arg; bool isVariadic = false; std::string function; bool operator==(const CountMismatch& rhs) const; }; struct FunctionDoesNotTakeSelf { bool operator==(const FunctionDoesNotTakeSelf& rhs) const; }; struct FunctionRequiresSelf { bool operator==(const FunctionRequiresSelf& rhs) const; }; struct OccursCheckFailed { bool operator==(const OccursCheckFailed& rhs) const; }; struct UnknownRequire { std::string modulePath; bool operator==(const UnknownRequire& rhs) const; }; struct IncorrectGenericParameterCount { Name name; TypeFun typeFun; size_t actualParameters; size_t actualPackParameters; bool operator==(const IncorrectGenericParameterCount& rhs) const; }; struct SyntaxError { std::string message; bool operator==(const SyntaxError& rhs) const; }; struct CodeTooComplex { bool operator==(const CodeTooComplex&) const; }; struct UnificationTooComplex { bool operator==(const UnificationTooComplex&) const; }; // Could easily be folded into UnknownProperty with an extra field, std::set candidates. // But for telemetry purposes, we want to have this be a distinct variant. struct UnknownPropButFoundLikeProp { TypeId table; Name key; std::set candidates; bool operator==(const UnknownPropButFoundLikeProp& rhs) const; }; struct GenericError { std::string message; bool operator==(const GenericError& rhs) const; }; struct InternalError { std::string message; bool operator==(const InternalError& rhs) const; }; struct CannotCallNonFunction { TypeId ty; bool operator==(const CannotCallNonFunction& rhs) const; }; struct ExtraInformation { std::string message; bool operator==(const ExtraInformation& rhs) const; }; struct DeprecatedApiUsed { std::string symbol; std::string useInstead; bool operator==(const DeprecatedApiUsed& rhs) const; }; struct ModuleHasCyclicDependency { std::vector cycle; bool operator==(const ModuleHasCyclicDependency& rhs) const; }; struct FunctionExitsWithoutReturning { TypePackId expectedReturnType; bool operator==(const FunctionExitsWithoutReturning& rhs) const; }; struct IllegalRequire { std::string moduleName; std::string reason; bool operator==(const IllegalRequire& rhs) const; }; struct MissingProperties { enum Context { Missing, Extra }; TypeId superType; TypeId subType; std::vector properties; Context context = Missing; bool operator==(const MissingProperties& rhs) const; }; struct DuplicateGenericParameter { std::string parameterName; bool operator==(const DuplicateGenericParameter& rhs) const; }; struct CannotInferBinaryOperation { enum OpKind { Operation, Comparison, }; AstExprBinary::Op op; std::optional suggestedToAnnotate; OpKind kind; bool operator==(const CannotInferBinaryOperation& rhs) const; }; struct SwappedGenericTypeParameter { enum Kind { Type, Pack, }; std::string name; // What was `name` being used as? Kind kind; bool operator==(const SwappedGenericTypeParameter& rhs) const; }; struct OptionalValueAccess { TypeId optional; bool operator==(const OptionalValueAccess& rhs) const; }; struct MissingUnionProperty { TypeId type; std::vector missing; Name key; bool operator==(const MissingUnionProperty& rhs) const; }; struct TypesAreUnrelated { TypeId left; TypeId right; bool operator==(const TypesAreUnrelated& rhs) const; }; struct NormalizationTooComplex { bool operator==(const NormalizationTooComplex&) const { return true; } }; struct TypePackMismatch { TypePackId wantedTp; TypePackId givenTp; std::string reason; bool operator==(const TypePackMismatch& rhs) const; }; struct DynamicPropertyLookupOnClassesUnsafe { TypeId ty; bool operator==(const DynamicPropertyLookupOnClassesUnsafe& rhs) const; }; struct UninhabitedTypeFamily { TypeId ty; bool operator==(const UninhabitedTypeFamily& rhs) const; }; struct ExplicitFunctionAnnotationRecommended { std::vector> recommendedArgs; TypeId recommendedReturn; bool operator==(const ExplicitFunctionAnnotationRecommended& rhs) const; }; struct UninhabitedTypePackFamily { TypePackId tp; bool operator==(const UninhabitedTypePackFamily& rhs) const; }; struct WhereClauseNeeded { TypeId ty; bool operator==(const WhereClauseNeeded& rhs) const; }; struct PackWhereClauseNeeded { TypePackId tp; bool operator==(const PackWhereClauseNeeded& rhs) const; }; struct CheckedFunctionCallError { TypeId expected; TypeId passed; std::string checkedFunctionName; // TODO: make this a vector size_t argumentIndex; bool operator==(const CheckedFunctionCallError& rhs) const; }; struct NonStrictFunctionDefinitionError { std::string functionName; std::string argument; TypeId argumentType; bool operator==(const NonStrictFunctionDefinitionError& rhs) const; }; struct PropertyAccessViolation { TypeId table; Name key; enum { CannotRead, CannotWrite } context; bool operator==(const PropertyAccessViolation& rhs) const; }; struct CheckedFunctionIncorrectArgs { std::string functionName; size_t expected; size_t actual; bool operator==(const CheckedFunctionIncorrectArgs& rhs) const; }; struct CannotAssignToNever { // type of the rvalue being assigned TypeId rhsType; // Originating type. std::vector cause; enum class Reason { // when assigning to a property in a union of tables, the properties type // is narrowed to the intersection of its type in each variant. PropertyNarrowed, }; Reason reason; bool operator==(const CannotAssignToNever& rhs) const; }; struct UnexpectedTypeInSubtyping { TypeId ty; bool operator==(const UnexpectedTypeInSubtyping& rhs) const; }; struct UnexpectedTypePackInSubtyping { TypePackId tp; bool operator==(const UnexpectedTypePackInSubtyping& rhs) const; }; using TypeErrorData = Variant; struct TypeErrorSummary { Location location; ModuleName moduleName; int code; TypeErrorSummary(const Location& location, const ModuleName& moduleName, int code) : location(location) , moduleName(moduleName) , code(code) { } }; struct TypeError { Location location; ModuleName moduleName; TypeErrorData data; static int minCode(); int code() const; TypeError() = default; TypeError(const Location& location, const ModuleName& moduleName, const TypeErrorData& data) : location(location) , moduleName(moduleName) , data(data) { } TypeError(const Location& location, const TypeErrorData& data) : TypeError(location, {}, data) { } bool operator==(const TypeError& rhs) const; TypeErrorSummary summary() const; }; template const T* get(const TypeError& e) { return get_if(&e.data); } template T* get(TypeError& e) { return get_if(&e.data); } using ErrorVec = std::vector; struct TypeErrorToStringOptions { FileResolver* fileResolver = nullptr; }; std::string toString(const TypeError& error); std::string toString(const TypeError& error, TypeErrorToStringOptions options); bool containsParseErrorName(const TypeError& error); // Copy any types named in the error into destArena. void copyErrors(ErrorVec& errors, struct TypeArena& destArena, NotNull builtinTypes); // Internal Compiler Error struct InternalErrorReporter { std::function onInternalError; std::string moduleName; [[noreturn]] void ice(const std::string& message, const Location& location) const; [[noreturn]] void ice(const std::string& message) const; }; class InternalCompilerError : public std::exception { public: explicit InternalCompilerError(const std::string& message) : message(message) { } explicit InternalCompilerError(const std::string& message, const std::string& moduleName) : message(message) , moduleName(moduleName) { } explicit InternalCompilerError(const std::string& message, const std::string& moduleName, const Location& location) : message(message) , moduleName(moduleName) , location(location) { } virtual const char* what() const throw(); const std::string message; const std::optional moduleName; const std::optional location; }; } // namespace Luau