luau-analyzer-sys 0.1.1

A high-performance, embedded Luau type-checking and analysis engine written in Rust. This crate provides bindings to the Luau analyzer, allowing you to integrate static analysis and code intelligence directly into your applications.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

// This file is part of the Luau programming language and is licensed under MIT License; see LICENSE.txt for details
#pragma once

#include "Luau/RequireNavigator.h"
#include "Luau/Require.h"

#include <chrono>
#include <string>

struct lua_State;
struct luarequire_Configuration;

namespace Luau::Require
{

class RuntimeLuauConfigTimer
{
public:
    void start(int timeoutMs);
    bool isFinished() const;

private:
    std::chrono::steady_clock::time_point startTime;
    std::optional<std::chrono::steady_clock::duration> timeoutDuration;
};

class RuntimeNavigationContext : public NavigationContext
{
public:
    RuntimeNavigationContext(luarequire_Configuration* config, lua_State* L, void* ctx, std::string requirerChunkname);

    // Navigation interface
    NavigateResult resetToRequirer() override;
    NavigateResult jumpToAlias(const std::string& path) override;

    NavigateResult toAliasOverride(const std::string& aliasUnprefixed) override;
    NavigateResult toAliasFallback(const std::string& aliasUnprefixed) override;

    NavigateResult toParent() override;
    NavigateResult toChild(const std::string& component) override;

    NavigationContext::ConfigStatus getConfigStatus() const override;
    NavigationContext::ConfigBehavior getConfigBehavior() const override;
    std::optional<std::string> getAlias(const std::string& alias) const override;
    std::optional<std::string> getConfig() const override;

    // Custom capabilities
    bool isModulePresent() const;
    std::optional<std::string> getChunkname() const;
    std::optional<std::string> getLoadname() const;
    std::optional<std::string> getCacheKey() const;

private:
    std::optional<std::string> getStringFromCWriter(
        luarequire_WriteResult (*writer)(lua_State* L, void* ctx, char* buffer, size_t buffer_size, size_t* size_out),
        size_t initalBufferSize
    ) const;
    std::optional<std::string> getStringFromCWriterWithInput(
        luarequire_WriteResult (*writer)(lua_State* L, void* ctx, const char* input, char* buffer, size_t buffer_size, size_t* size_out),
        std::string input,
        size_t initalBufferSize
    ) const;

    luarequire_Configuration* config;
    lua_State* L;
    void* ctx;
    std::string requirerChunkname;
    RuntimeLuauConfigTimer timer = RuntimeLuauConfigTimer{};
};

// Non-throwing error reporter
class RuntimeErrorHandler : public ErrorHandler
{
public:
    RuntimeErrorHandler(std::string requiredPath);
    void reportError(std::string message) override;

    const std::string& getReportedError() const;

private:
    std::string errorPrefix;
    std::string errorMessage;
};

} // namespace Luau::Require