// This file is part of the Luau programming language and is licensed under MIT License; see LICENSE.txt for details #pragma once #include "Luau/Ast.h" // Used for some of the enumerations #include "Luau/DenseHash.h" #include "Luau/NotNull.h" #include "Luau/Type.h" #include "Luau/Variant.h" #include #include #include namespace Luau { struct Scope; struct Type; using TypeId = const Type*; struct TypePackVar; using TypePackId = const TypePackVar*; // subType <: superType struct SubtypeConstraint { TypeId subType; TypeId superType; }; // subPack <: superPack struct PackSubtypeConstraint { TypePackId subPack; TypePackId superPack; // HACK!! TODO clip. // We need to know which of `PackSubtypeConstraint` are emitted from `AstStatReturn` vs any others. // Then we force these specific `PackSubtypeConstraint` to only dispatch in the order of the `return`s. bool returns = false; }; // generalizedType ~ gen sourceType struct GeneralizationConstraint { TypeId generalizedType; TypeId sourceType; }; // subType ~ inst superType struct InstantiationConstraint { TypeId subType; TypeId superType; }; struct UnaryConstraint { AstExprUnary::Op op; TypeId operandType; TypeId resultType; }; // let L : leftType // let R : rightType // in // L op R : resultType struct BinaryConstraint { AstExprBinary::Op op; TypeId leftType; TypeId rightType; TypeId resultType; // When we dispatch this constraint, we update the key at this map to record // the overload that we selected. const AstNode* astFragment; DenseHashMap* astOriginalCallTypes; DenseHashMap* astOverloadResolvedTypes; }; // iteratee is iterable // iterators is the iteration types. struct IterableConstraint { TypePackId iterator; TypePackId variables; const AstNode* nextAstFragment; DenseHashMap* astForInNextTypes; }; // name(namedType) = name struct NameConstraint { TypeId namedType; std::string name; bool synthetic = false; std::vector typeParameters; std::vector typePackParameters; }; // target ~ inst target struct TypeAliasExpansionConstraint { // Must be a PendingExpansionType. TypeId target; }; struct FunctionCallConstraint { TypeId fn; TypePackId argsPack; TypePackId result; class AstExprCall* callSite = nullptr; std::vector> discriminantTypes; // When we dispatch this constraint, we update the key at this map to record // the overload that we selected. DenseHashMap* astOverloadResolvedTypes = nullptr; }; // result ~ prim ExpectedType SomeSingletonType MultitonType // // If ExpectedType is potentially a singleton (an actual singleton or a union // that contains a singleton), then result ~ SomeSingletonType // // else result ~ MultitonType struct PrimitiveTypeConstraint { TypeId resultType; TypeId expectedType; TypeId singletonType; TypeId multitonType; }; // result ~ hasProp type "prop_name" // // If the subject is a table, bind the result to the named prop. If the table // has an indexer, bind it to the index result type. If the subject is a union, // bind the result to the union of its constituents' properties. // // It would be nice to get rid of this constraint and someday replace it with // // T <: {p: X} // // Where {} describes an inexact shape type. struct HasPropConstraint { TypeId resultType; TypeId subjectType; std::string prop; // HACK: We presently need types like true|false or string|"hello" when // deciding whether a particular literal expression should have a singleton // type. This boolean is set to true when extracting the property type of a // value that may be a union of tables. // // For example, in the following code fragment, we want the lookup of the // success property to yield true|false when extracting an expectedType in // this expression: // // type Result = {success:true, result: T} | {success:false, error: E} // // local r: Result = {success=true, result=9} // // If we naively simplify the expectedType to boolean, we will erroneously // compute the type boolean for the success property of the table literal. // This causes type checking to fail. bool suppressSimplification = false; }; // result ~ setProp subjectType ["prop", "prop2", ...] propType // // If the subject is a table or table-like thing that already has the named // property chain, we unify propType with that existing property type. // // If the subject is a free table, we augment it in place. // // If the subject is an unsealed table, result is an augmented table that // includes that new prop. struct SetPropConstraint { TypeId resultType; TypeId subjectType; std::vector path; TypeId propType; }; // result ~ setIndexer subjectType indexType propType // // If the subject is a table or table-like thing that already has an indexer, // unify its indexType and propType with those from this constraint. // // If the table is a free or unsealed table, we augment it with a new indexer. struct SetIndexerConstraint { TypeId resultType; TypeId subjectType; TypeId indexType; TypeId propType; }; // if negation: // result ~ if isSingleton D then ~D else unknown where D = discriminantType // if not negation: // result ~ if isSingleton D then D else unknown where D = discriminantType struct SingletonOrTopTypeConstraint { TypeId resultType; TypeId discriminantType; bool negated; }; // resultType ~ unpack sourceTypePack // // Similar to PackSubtypeConstraint, but with one important difference: If the // sourcePack is blocked, this constraint blocks. struct UnpackConstraint { TypePackId resultPack; TypePackId sourcePack; }; // resultType ~ refine type mode discriminant // // Compute type & discriminant (or type | discriminant) as soon as possible (but // no sooner), simplify, and bind resultType to that type. struct RefineConstraint { enum { Intersection, Union } mode; TypeId resultType; TypeId type; TypeId discriminant; }; // ty ~ reduce ty // // Try to reduce ty, if it is a TypeFamilyInstanceType. Otherwise, do nothing. struct ReduceConstraint { TypeId ty; }; // tp ~ reduce tp // // Analogous to ReduceConstraint, but for type packs. struct ReducePackConstraint { TypePackId tp; }; using ConstraintV = Variant; struct Constraint { Constraint(NotNull scope, const Location& location, ConstraintV&& c); Constraint(const Constraint&) = delete; Constraint& operator=(const Constraint&) = delete; NotNull scope; Location location; ConstraintV c; std::vector> dependencies; }; using ConstraintPtr = std::unique_ptr; inline Constraint& asMutable(const Constraint& c) { return const_cast(c); } template T* getMutable(Constraint& c) { return ::Luau::get_if(&c.c); } template const T* get(const Constraint& c) { return getMutable(asMutable(c)); } } // namespace Luau