2022-06-03 23:15:45 +01:00
|
|
|
// This file is part of the Luau programming language and is licensed under MIT License; see LICENSE.txt for details
|
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
2022-06-17 02:05:14 +01:00
|
|
|
#include "Luau/Constraint.h"
|
2022-12-09 19:57:01 +00:00
|
|
|
#include "Luau/Error.h"
|
|
|
|
#include "Luau/Module.h"
|
2022-10-07 01:23:29 +01:00
|
|
|
#include "Luau/Normalize.h"
|
2022-12-09 19:57:01 +00:00
|
|
|
#include "Luau/ToString.h"
|
2023-01-04 20:53:17 +00:00
|
|
|
#include "Luau/Type.h"
|
2022-12-09 19:57:01 +00:00
|
|
|
#include "Luau/Variant.h"
|
2022-06-03 23:15:45 +01:00
|
|
|
|
|
|
|
#include <vector>
|
|
|
|
|
|
|
|
namespace Luau
|
|
|
|
{
|
|
|
|
|
2022-09-08 23:14:25 +01:00
|
|
|
struct DcrLogger;
|
|
|
|
|
2022-06-03 23:15:45 +01:00
|
|
|
// TypeId, TypePackId, or Constraint*. It is impossible to know which, but we
|
|
|
|
// never dereference this pointer.
|
2023-02-24 21:49:38 +00:00
|
|
|
using BlockedConstraintId = Variant<TypeId, TypePackId, const Constraint*>;
|
|
|
|
|
|
|
|
struct HashBlockedConstraintId
|
|
|
|
{
|
|
|
|
size_t operator()(const BlockedConstraintId& bci) const;
|
|
|
|
};
|
2022-06-03 23:15:45 +01:00
|
|
|
|
2022-09-02 00:14:03 +01:00
|
|
|
struct ModuleResolver;
|
|
|
|
|
2022-08-04 23:35:33 +01:00
|
|
|
struct InstantiationSignature
|
|
|
|
{
|
|
|
|
TypeFun fn;
|
|
|
|
std::vector<TypeId> arguments;
|
|
|
|
std::vector<TypePackId> packArguments;
|
|
|
|
|
|
|
|
bool operator==(const InstantiationSignature& rhs) const;
|
|
|
|
bool operator!=(const InstantiationSignature& rhs) const
|
|
|
|
{
|
|
|
|
return !((*this) == rhs);
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
|
|
|
struct HashInstantiationSignature
|
|
|
|
{
|
|
|
|
size_t operator()(const InstantiationSignature& signature) const;
|
|
|
|
};
|
|
|
|
|
2022-06-03 23:15:45 +01:00
|
|
|
struct ConstraintSolver
|
|
|
|
{
|
2023-04-21 23:14:26 +01:00
|
|
|
NotNull<TypeArena> arena;
|
2023-01-04 20:53:17 +00:00
|
|
|
NotNull<BuiltinTypes> builtinTypes;
|
2022-06-03 23:15:45 +01:00
|
|
|
InternalErrorReporter iceReporter;
|
2022-10-07 01:23:29 +01:00
|
|
|
NotNull<Normalizer> normalizer;
|
2022-08-04 23:35:33 +01:00
|
|
|
// The entire set of constraints that the solver is trying to resolve.
|
|
|
|
std::vector<NotNull<Constraint>> constraints;
|
2022-07-29 05:24:07 +01:00
|
|
|
NotNull<Scope> rootScope;
|
2022-09-02 00:14:03 +01:00
|
|
|
ModuleName currentModuleName;
|
2022-06-03 23:15:45 +01:00
|
|
|
|
2022-08-04 23:35:33 +01:00
|
|
|
// Constraints that the solver has generated, rather than sourcing from the
|
|
|
|
// scope tree.
|
|
|
|
std::vector<std::unique_ptr<Constraint>> solverConstraints;
|
|
|
|
|
2022-06-03 23:15:45 +01:00
|
|
|
// This includes every constraint that has not been fully solved.
|
|
|
|
// A constraint can be both blocked and unsolved, for instance.
|
2022-06-17 02:05:14 +01:00
|
|
|
std::vector<NotNull<const Constraint>> unsolvedConstraints;
|
2022-06-03 23:15:45 +01:00
|
|
|
|
|
|
|
// A mapping of constraint pointer to how many things the constraint is
|
|
|
|
// blocked on. Can be empty or 0 for constraints that are not blocked on
|
|
|
|
// anything.
|
2022-06-17 02:05:14 +01:00
|
|
|
std::unordered_map<NotNull<const Constraint>, size_t> blockedConstraints;
|
2022-06-03 23:15:45 +01:00
|
|
|
// A mapping of type/pack pointers to the constraints they block.
|
2023-02-24 21:49:38 +00:00
|
|
|
std::unordered_map<BlockedConstraintId, std::vector<NotNull<const Constraint>>, HashBlockedConstraintId> blocked;
|
2022-08-04 23:35:33 +01:00
|
|
|
// Memoized instantiations of type aliases.
|
|
|
|
DenseHashMap<InstantiationSignature, TypeId, HashInstantiationSignature> instantiatedAliases{{}};
|
2022-06-17 02:05:14 +01:00
|
|
|
|
2022-08-18 22:32:08 +01:00
|
|
|
// Recorded errors that take place within the solver.
|
|
|
|
ErrorVec errors;
|
|
|
|
|
2022-09-02 00:14:03 +01:00
|
|
|
NotNull<ModuleResolver> moduleResolver;
|
|
|
|
std::vector<RequireCycle> requireCycles;
|
|
|
|
|
2022-09-08 23:14:25 +01:00
|
|
|
DcrLogger* logger;
|
2022-06-03 23:15:45 +01:00
|
|
|
|
2022-11-10 22:53:13 +00:00
|
|
|
explicit ConstraintSolver(NotNull<Normalizer> normalizer, NotNull<Scope> rootScope, std::vector<NotNull<Constraint>> constraints,
|
2023-03-31 19:42:49 +01:00
|
|
|
ModuleName moduleName, NotNull<ModuleResolver> moduleResolver, std::vector<RequireCycle> requireCycles, DcrLogger* logger);
|
2022-06-03 23:15:45 +01:00
|
|
|
|
2022-10-07 01:23:29 +01:00
|
|
|
// Randomize the order in which to dispatch constraints
|
|
|
|
void randomize(unsigned seed);
|
|
|
|
|
2022-06-03 23:15:45 +01:00
|
|
|
/**
|
|
|
|
* Attempts to dispatch all pending constraints and reach a type solution
|
2022-06-17 02:05:14 +01:00
|
|
|
* that satisfies all of the constraints.
|
2022-06-03 23:15:45 +01:00
|
|
|
**/
|
|
|
|
void run();
|
|
|
|
|
2022-10-14 20:48:41 +01:00
|
|
|
bool isDone();
|
|
|
|
|
|
|
|
void finalizeModule();
|
2022-06-03 23:15:45 +01:00
|
|
|
|
2022-10-07 01:23:29 +01:00
|
|
|
/** Attempt to dispatch a constraint. Returns true if it was successful. If
|
|
|
|
* tryDispatch() returns false, the constraint remains in the unsolved set
|
|
|
|
* and will be retried later.
|
2022-07-01 00:52:43 +01:00
|
|
|
*/
|
2022-06-17 02:05:14 +01:00
|
|
|
bool tryDispatch(NotNull<const Constraint> c, bool force);
|
2022-07-01 00:52:43 +01:00
|
|
|
|
2022-06-17 02:05:14 +01:00
|
|
|
bool tryDispatch(const SubtypeConstraint& c, NotNull<const Constraint> constraint, bool force);
|
|
|
|
bool tryDispatch(const PackSubtypeConstraint& c, NotNull<const Constraint> constraint, bool force);
|
|
|
|
bool tryDispatch(const GeneralizationConstraint& c, NotNull<const Constraint> constraint, bool force);
|
|
|
|
bool tryDispatch(const InstantiationConstraint& c, NotNull<const Constraint> constraint, bool force);
|
2022-07-01 00:52:43 +01:00
|
|
|
bool tryDispatch(const UnaryConstraint& c, NotNull<const Constraint> constraint, bool force);
|
|
|
|
bool tryDispatch(const BinaryConstraint& c, NotNull<const Constraint> constraint, bool force);
|
2022-09-02 00:14:03 +01:00
|
|
|
bool tryDispatch(const IterableConstraint& c, NotNull<const Constraint> constraint, bool force);
|
2022-06-24 02:56:00 +01:00
|
|
|
bool tryDispatch(const NameConstraint& c, NotNull<const Constraint> constraint);
|
2022-08-04 23:35:33 +01:00
|
|
|
bool tryDispatch(const TypeAliasExpansionConstraint& c, NotNull<const Constraint> constraint);
|
2022-09-02 00:14:03 +01:00
|
|
|
bool tryDispatch(const FunctionCallConstraint& c, NotNull<const Constraint> constraint);
|
2022-09-23 20:17:25 +01:00
|
|
|
bool tryDispatch(const PrimitiveTypeConstraint& c, NotNull<const Constraint> constraint);
|
|
|
|
bool tryDispatch(const HasPropConstraint& c, NotNull<const Constraint> constraint);
|
2023-01-20 20:27:03 +00:00
|
|
|
bool tryDispatch(const SetPropConstraint& c, NotNull<const Constraint> constraint, bool force);
|
2023-02-24 21:49:38 +00:00
|
|
|
bool tryDispatch(const SetIndexerConstraint& c, NotNull<const Constraint> constraint, bool force);
|
2022-11-04 17:33:22 +00:00
|
|
|
bool tryDispatch(const SingletonOrTopTypeConstraint& c, NotNull<const Constraint> constraint);
|
2023-02-24 21:49:38 +00:00
|
|
|
bool tryDispatch(const UnpackConstraint& c, NotNull<const Constraint> constraint);
|
2023-05-19 20:37:30 +01:00
|
|
|
bool tryDispatch(const RefineConstraint& c, NotNull<const Constraint> constraint, bool force);
|
2023-05-12 18:50:47 +01:00
|
|
|
bool tryDispatch(const ReduceConstraint& c, NotNull<const Constraint> constraint, bool force);
|
|
|
|
bool tryDispatch(const ReducePackConstraint& c, NotNull<const Constraint> constraint, bool force);
|
2022-09-02 00:14:03 +01:00
|
|
|
|
|
|
|
// for a, ... in some_table do
|
2022-09-29 23:23:10 +01:00
|
|
|
// also handles __iter metamethod
|
2022-09-02 00:14:03 +01:00
|
|
|
bool tryDispatchIterableTable(TypeId iteratorTy, const IterableConstraint& c, NotNull<const Constraint> constraint, bool force);
|
|
|
|
|
|
|
|
// for a, ... in next_function, t, ... do
|
|
|
|
bool tryDispatchIterableFunction(
|
|
|
|
TypeId nextTy, TypeId tableTy, TypeId firstIndexTy, const IterableConstraint& c, NotNull<const Constraint> constraint, bool force);
|
2022-06-03 23:15:45 +01:00
|
|
|
|
2023-05-19 20:37:30 +01:00
|
|
|
std::pair<std::vector<TypeId>, std::optional<TypeId>> lookupTableProp(
|
|
|
|
TypeId subjectType, const std::string& propName, bool suppressSimplification = false);
|
|
|
|
std::pair<std::vector<TypeId>, std::optional<TypeId>> lookupTableProp(
|
|
|
|
TypeId subjectType, const std::string& propName, bool suppressSimplification, std::unordered_set<TypeId>& seen);
|
2022-11-18 19:47:21 +00:00
|
|
|
|
2022-06-17 02:05:14 +01:00
|
|
|
void block(NotNull<const Constraint> target, NotNull<const Constraint> constraint);
|
2022-06-03 23:15:45 +01:00
|
|
|
/**
|
2023-01-04 20:53:17 +00:00
|
|
|
* Block a constraint on the resolution of a Type.
|
2022-06-17 02:05:14 +01:00
|
|
|
* @returns false always. This is just to allow tryDispatch to return the result of block()
|
|
|
|
*/
|
|
|
|
bool block(TypeId target, NotNull<const Constraint> constraint);
|
|
|
|
bool block(TypePackId target, NotNull<const Constraint> constraint);
|
2022-06-03 23:15:45 +01:00
|
|
|
|
2023-05-19 20:37:30 +01:00
|
|
|
// Block on every target
|
|
|
|
template<typename T>
|
|
|
|
bool block(const T& targets, NotNull<const Constraint> constraint)
|
|
|
|
{
|
|
|
|
for (TypeId target : targets)
|
|
|
|
block(target, constraint);
|
|
|
|
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
2023-03-17 19:20:37 +00:00
|
|
|
/**
|
|
|
|
* For all constraints that are blocked on one constraint, make them block
|
|
|
|
* on a new constraint.
|
|
|
|
* @param source the constraint to copy blocks from.
|
|
|
|
* @param addition the constraint that other constraints should now block on.
|
|
|
|
*/
|
|
|
|
void inheritBlocks(NotNull<const Constraint> source, NotNull<const Constraint> addition);
|
|
|
|
|
2023-05-19 20:37:30 +01:00
|
|
|
// Traverse the type. If any pending types are found, block the constraint
|
|
|
|
// on them.
|
2022-09-23 20:17:25 +01:00
|
|
|
//
|
|
|
|
// Returns false if a type blocks the constraint.
|
|
|
|
//
|
|
|
|
// FIXME: This use of a boolean for the return result is an appalling
|
|
|
|
// interface.
|
2023-05-19 20:37:30 +01:00
|
|
|
bool blockOnPendingTypes(TypeId target, NotNull<const Constraint> constraint);
|
|
|
|
bool blockOnPendingTypes(TypePackId target, NotNull<const Constraint> constraint);
|
2022-09-23 20:17:25 +01:00
|
|
|
|
2022-06-17 02:05:14 +01:00
|
|
|
void unblock(NotNull<const Constraint> progressed);
|
2023-06-16 18:35:18 +01:00
|
|
|
void unblock(TypeId progressed, Location location);
|
|
|
|
void unblock(TypePackId progressed, Location location);
|
|
|
|
void unblock(const std::vector<TypeId>& types, Location location);
|
|
|
|
void unblock(const std::vector<TypePackId>& packs, Location location);
|
2022-06-03 23:15:45 +01:00
|
|
|
|
2022-06-17 02:05:14 +01:00
|
|
|
/**
|
|
|
|
* @returns true if the TypeId is in a blocked state.
|
|
|
|
*/
|
|
|
|
bool isBlocked(TypeId ty);
|
|
|
|
|
2022-09-02 00:14:03 +01:00
|
|
|
/**
|
|
|
|
* @returns true if the TypePackId is in a blocked state.
|
|
|
|
*/
|
|
|
|
bool isBlocked(TypePackId tp);
|
|
|
|
|
2022-06-03 23:15:45 +01:00
|
|
|
/**
|
|
|
|
* Returns whether the constraint is blocked on anything.
|
|
|
|
* @param constraint the constraint to check.
|
|
|
|
*/
|
2022-06-17 02:05:14 +01:00
|
|
|
bool isBlocked(NotNull<const Constraint> constraint);
|
2022-06-03 23:15:45 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Creates a new Unifier and performs a single unification operation. Commits
|
2022-06-17 02:05:14 +01:00
|
|
|
* the result.
|
2022-06-03 23:15:45 +01:00
|
|
|
* @param subType the sub-type to unify.
|
|
|
|
* @param superType the super-type to unify.
|
|
|
|
*/
|
2023-05-25 22:36:34 +01:00
|
|
|
ErrorVec unify(TypeId subType, TypeId superType, NotNull<Scope> scope);
|
2022-06-03 23:15:45 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Creates a new Unifier and performs a single unification operation. Commits
|
2022-06-17 02:05:14 +01:00
|
|
|
* the result.
|
2022-06-03 23:15:45 +01:00
|
|
|
* @param subPack the sub-type pack to unify.
|
|
|
|
* @param superPack the super-type pack to unify.
|
|
|
|
*/
|
2023-05-25 22:36:34 +01:00
|
|
|
ErrorVec unify(TypePackId subPack, TypePackId superPack, NotNull<Scope> scope);
|
2022-06-17 02:05:14 +01:00
|
|
|
|
2022-08-04 23:35:33 +01:00
|
|
|
/** Pushes a new solver constraint to the solver.
|
|
|
|
* @param cv the body of the constraint.
|
|
|
|
**/
|
2023-02-17 23:41:51 +00:00
|
|
|
NotNull<Constraint> pushConstraint(NotNull<Scope> scope, const Location& location, ConstraintV cv);
|
2022-09-02 00:14:03 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Attempts to resolve a module from its module information. Returns the
|
|
|
|
* module-level return type of the module, or the error type if one cannot
|
|
|
|
* be found. Reports errors to the solver if the module cannot be found or
|
|
|
|
* the require is illegal.
|
|
|
|
* @param module the module information to look up.
|
|
|
|
* @param location the location where the require is taking place; used for
|
|
|
|
* error locations.
|
|
|
|
**/
|
|
|
|
TypeId resolveModule(const ModuleInfo& module, const Location& location);
|
2022-08-04 23:35:33 +01:00
|
|
|
|
2022-08-18 22:32:08 +01:00
|
|
|
void reportError(TypeErrorData&& data, const Location& location);
|
|
|
|
void reportError(TypeError e);
|
2022-09-02 00:14:03 +01:00
|
|
|
|
2022-06-17 02:05:14 +01:00
|
|
|
private:
|
2023-03-31 19:42:49 +01:00
|
|
|
|
|
|
|
/** Helper used by tryDispatch(SubtypeConstraint) and
|
|
|
|
* tryDispatch(PackSubtypeConstraint)
|
|
|
|
*
|
|
|
|
* Attempts to unify subTy with superTy. If doing so would require unifying
|
|
|
|
* BlockedTypes, fail and block the constraint on those BlockedTypes.
|
|
|
|
*
|
|
|
|
* If unification fails, replace all free types with errorType.
|
|
|
|
*
|
|
|
|
* If unification succeeds, unblock every type changed by the unification.
|
|
|
|
*/
|
|
|
|
template <typename TID>
|
|
|
|
bool tryUnify(NotNull<const Constraint> constraint, TID subTy, TID superTy);
|
|
|
|
|
2023-06-24 07:19:39 +01:00
|
|
|
/**
|
|
|
|
* Bind a BlockedType to another type while taking care not to bind it to
|
|
|
|
* itself in the case that resultTy == blockedTy. This can happen if we
|
|
|
|
* have a tautological constraint. When it does, we must instead bind
|
|
|
|
* blockedTy to a fresh type belonging to an appropriate scope.
|
|
|
|
*
|
|
|
|
* To determine which scope is appropriate, we also accept rootTy, which is
|
|
|
|
* to be the type that contains blockedTy.
|
|
|
|
*/
|
|
|
|
void bindBlockedType(TypeId blockedTy, TypeId resultTy, TypeId rootTy, Location location);
|
|
|
|
|
2022-06-17 02:05:14 +01:00
|
|
|
/**
|
|
|
|
* Marks a constraint as being blocked on a type or type pack. The constraint
|
|
|
|
* solver will not attempt to dispatch blocked constraints until their
|
|
|
|
* dependencies have made progress.
|
|
|
|
* @param target the type or type pack pointer that the constraint is blocked on.
|
|
|
|
* @param constraint the constraint to block.
|
|
|
|
**/
|
|
|
|
void block_(BlockedConstraintId target, NotNull<const Constraint> constraint);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Informs the solver that progress has been made on a type or type pack. The
|
|
|
|
* solver will wake up all constraints that are blocked on the type or type pack,
|
|
|
|
* and will resume attempting to dispatch them.
|
|
|
|
* @param progressed the type or type pack pointer that has progressed.
|
|
|
|
**/
|
|
|
|
void unblock_(BlockedConstraintId progressed);
|
2022-09-02 00:14:03 +01:00
|
|
|
|
2022-09-15 23:38:17 +01:00
|
|
|
TypeId errorRecoveryType() const;
|
|
|
|
TypePackId errorRecoveryTypePack() const;
|
|
|
|
|
2022-10-21 18:54:01 +01:00
|
|
|
TypeId unionOfTypes(TypeId a, TypeId b, NotNull<Scope> scope, bool unifyFreeTypes);
|
|
|
|
|
2023-05-19 20:37:30 +01:00
|
|
|
TypePackId anyifyModuleReturnTypePackGenerics(TypePackId tp);
|
|
|
|
|
2022-09-02 00:14:03 +01:00
|
|
|
ToStringOptions opts;
|
2022-06-03 23:15:45 +01:00
|
|
|
};
|
|
|
|
|
2022-07-29 05:24:07 +01:00
|
|
|
void dump(NotNull<Scope> rootScope, struct ToStringOptions& opts);
|
2022-06-03 23:15:45 +01:00
|
|
|
|
|
|
|
} // namespace Luau
|