mirror of
https://github.com/luau-lang/luau.git
synced 2025-05-02 09:33:48 +01:00
c51743268b
# General * Internally rename `ClassType` to `ExternType`. In definition files, the syntax to define these types has changed to `declare extern type Foo with prop: type end` * Add `luarequire_registermodule` to Luau.Require * Support yieldable Luau C functions calling other functions * Store return types as `AstTypePack*` on Ast nodes ## New Solver * Improve the logic that determines constraint dispatch ordering * Fix a crash in the type solver that arose when using multi-return functions with `string.format` * Fix https://github.com/luau-lang/luau/issues/1736 * Initial steps toward rethinking function generalization: * Instead of generalizing every type in a function all at once, we will instead generalize individual type variables once their bounds have been fully resolved. This will make it possible to properly interleave type function reduction and generalization. * Magic functions are no longer considered magical in cases where they are not explicitly called by the code. * The most prominent example of this is in `for..in` loops where the function call is part of the desugaring process. * Almost all magic functions work by directly inspecting the AST, so they can't work without an AST fragment anyway. * Further, none of the magic functions we have are usefully used in this way. Co-authored-by: Andy Friesen <afriesen@roblox.com> Co-authored-by: Ariel Weiss <aaronweiss@roblox.com> Co-authored-by: Hunter Goldstein <hgoldstein@roblox.com> Co-authored-by: Sora Kanosue <skanosue@roblox.com> Co-authored-by: Talha Pathan <tpathan@roblox.com> Co-authored-by: Varun Saini <vsaini@roblox.com> Co-authored-by: Vighnesh Vijay <vvijay@roblox.com> Co-authored-by: Vyacheslav Egorov <vegorov@roblox.com>
95 lines
3.1 KiB
C++
95 lines
3.1 KiB
C++
// This file is part of the Luau programming language and is licensed under MIT License; see LICENSE.txt for details
|
|
#pragma once
|
|
|
|
#include "Luau/Config.h"
|
|
|
|
#include <optional>
|
|
#include <string>
|
|
#include <string_view>
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// The RequireNavigator library provides a C++ interface for navigating the
|
|
// context in which require-by-string operates. This is used internally by the
|
|
// require-by-string runtime library to resolve paths based on the rules defined
|
|
// by its consumers.
|
|
//
|
|
// Directly linking against this library allows for inspection of the
|
|
// require-by-string path resolution algorithm's behavior without enabling the
|
|
// runtime library, which is useful for static tooling as well.
|
|
//
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
namespace Luau::Require
|
|
{
|
|
|
|
// The ErrorHandler interface is used to report errors during navigation.
|
|
// The default implementation does nothing but can be overridden to enable
|
|
// custom error handling behavior.
|
|
class ErrorHandler
|
|
{
|
|
public:
|
|
virtual ~ErrorHandler() = default;
|
|
virtual void reportError(std::string message) {}
|
|
};
|
|
|
|
// NavigationContext is an pure virtual class that is intended to be implemented
|
|
// and injected into a Navigator.
|
|
//
|
|
// When a Navigator traverses a require path, its NavigationContext's methods
|
|
// are invoked, with the expectation that the NavigationContext will keep track
|
|
// of the current state of the navigation and provide information about the
|
|
// current context as needed.
|
|
class NavigationContext
|
|
{
|
|
public:
|
|
virtual ~NavigationContext() = default;
|
|
virtual std::string getRequirerIdentifier() const = 0;
|
|
|
|
enum class NavigateResult
|
|
{
|
|
Success,
|
|
Ambiguous,
|
|
NotFound
|
|
};
|
|
|
|
virtual NavigateResult reset(const std::string& identifier) = 0;
|
|
virtual NavigateResult jumpToAlias(const std::string& path) = 0;
|
|
|
|
virtual NavigateResult toParent() = 0;
|
|
virtual NavigateResult toChild(const std::string& component) = 0;
|
|
|
|
virtual bool isConfigPresent() const = 0;
|
|
virtual std::optional<std::string> getConfig() const = 0;
|
|
};
|
|
|
|
// The Navigator class is responsible for traversing a given require path in the
|
|
// context of a given NavigationContext.
|
|
//
|
|
// The Navigator is not intended to be overridden. Rather, it expects a custom
|
|
// injected NavigationContext that provides the desired navigation behavior.
|
|
class Navigator
|
|
{
|
|
public:
|
|
enum class Status
|
|
{
|
|
Success,
|
|
ErrorReported
|
|
};
|
|
|
|
Navigator(NavigationContext& navigationContext, ErrorHandler& errorHandler);
|
|
[[nodiscard]] Status navigate(std::string path);
|
|
|
|
private:
|
|
using Error = std::optional<std::string>;
|
|
[[nodiscard]] Error navigateImpl(std::string_view path);
|
|
[[nodiscard]] Error navigateThroughPath(std::string_view path);
|
|
[[nodiscard]] Error navigateToAlias(const std::string& alias, const std::string& value);
|
|
[[nodiscard]] Error navigateToAndPopulateConfig(const std::string& desiredAlias);
|
|
|
|
NavigationContext& navigationContext;
|
|
ErrorHandler& errorHandler;
|
|
Luau::Config config;
|
|
};
|
|
|
|
} // namespace Luau::Require
|