// This file is part of the Luau programming language and is licensed under MIT License; see LICENSE.txt for details #pragma once #include "Luau/Constraint.h" #include "Luau/Location.h" #include "Luau/NotNull.h" #include "Luau/TypeVar.h" #include #include #include namespace Luau { struct Scope; using ScopePtr = std::shared_ptr; struct Binding { TypeId typeId; Location location; bool deprecated = false; std::string deprecatedSuggestion; std::optional documentationSymbol; }; struct Scope { explicit Scope(TypePackId returnType); // root scope explicit Scope(const ScopePtr& parent, int subLevel = 0); // child scope. Parent must not be nullptr. const ScopePtr parent; // null for the root std::unordered_map bindings; TypePackId returnType; bool breakOk = false; std::optional varargPack; TypeLevel level; std::unordered_map exportedTypeBindings; std::unordered_map privateTypeBindings; std::unordered_map typeAliasLocations; std::unordered_map> importedTypeBindings; std::optional lookup(const Symbol& name); std::optional lookupType(const Name& name); std::optional lookupImportedType(const Name& moduleAlias, const Name& name); std::unordered_map privateTypePackBindings; std::optional lookupPack(const Name& name); // WARNING: This function linearly scans for a string key of equal value! It is thus O(n**2) std::optional linearSearchForBinding(const std::string& name, bool traverseScopeChain = true); RefinementMap refinements; // For mutually recursive type aliases, it's important that // they use the same types for the same names. // For instance, in `type Tree { data: T, children: Forest } type Forest = {Tree}` // we need that the generic type `T` in both cases is the same, so we use a cache. std::unordered_map typeAliasTypeParameters; std::unordered_map typeAliasTypePackParameters; }; struct Scope2 { // The parent scope of this scope. Null if there is no parent (i.e. this // is the module-level scope). Scope2* parent = nullptr; // All the children of this scope. std::vector> children; std::unordered_map bindings; // TODO: I think this can be a DenseHashMap std::unordered_map typeBindings; std::unordered_map typePackBindings; TypePackId returnType; std::optional varargPack; // All constraints belonging to this scope. std::vector constraints; std::optional lookup(Symbol sym); std::optional lookupTypeBinding(const Name& name); std::optional lookupTypePackBinding(const Name& name); }; } // namespace Luau