Everywhere: Hoist the Libraries folder to the top-level

Author: https://github.com/trflynn89 Commit: 93712b24bf Pull-request: https://github.com/LadybirdBrowser/ladybird/pull/2256 Reviewed-by: https://github.com/sideshowbarker
2025-09-12 20:42:21 +00:00 · 2024-11-09 12:25:08 -05:00 · 2024-11-09 12:25:08 -05:00 · 93712b24bf · 2024-11-10 11:51:52 +00:00
commit 93712b24bf
parent 950e819ee7
4547 changed files with 104 additions and 113 deletions
--- a/Libraries/LibJS/Runtime/Reference.h
+++ b/Libraries/LibJS/Runtime/Reference.h
@ -0,0 +1,140 @@
+/*
+ * Copyright (c) 2020-2021, Andreas Kling <andreas@ladybird.org>
+ *
+ * SPDX-License-Identifier: BSD-2-Clause
+ */
+
+#pragma once
+
+#include <LibJS/Runtime/Environment.h>
+#include <LibJS/Runtime/EnvironmentCoordinate.h>
+#include <LibJS/Runtime/PropertyKey.h>
+#include <LibJS/Runtime/Value.h>
+
+namespace JS {
+
+Reference make_private_reference(VM&, Value base_value, DeprecatedFlyString const& private_identifier);
+
+class Reference {
+public:
+    enum class BaseType : u8 {
+        Unresolvable,
+        Value,
+        Environment,
+    };
+
+    Reference(BaseType type, PropertyKey name, bool strict)
+        : m_base_type(type)
+        , m_name(move(name))
+        , m_strict(strict)
+    {
+    }
+
+    Reference(Value base, PropertyKey name, Value this_value, bool strict = false)
+        : m_base_type(BaseType::Value)
+        , m_base_value(base)
+        , m_name(move(name))
+        , m_this_value(this_value)
+        , m_strict(strict)
+    {
+    }
+
+    Reference(Environment& base, DeprecatedFlyString referenced_name, bool strict = false, Optional<EnvironmentCoordinate> environment_coordinate = {})
+        : m_base_type(BaseType::Environment)
+        , m_base_environment(&base)
+        , m_name(move(referenced_name))
+        , m_strict(strict)
+        , m_environment_coordinate(move(environment_coordinate))
+    {
+    }
+
+    Reference(Value base, PrivateName name)
+        : m_base_type(BaseType::Value)
+        , m_base_value(base)
+        , m_name(move(name))
+        , m_strict(true)
+    {
+    }
+
+    Value base() const
+    {
+        VERIFY(m_base_type == BaseType::Value);
+        return m_base_value;
+    }
+
+    Environment& base_environment() const
+    {
+        VERIFY(m_base_type == BaseType::Environment);
+        return *m_base_environment;
+    }
+
+    PropertyKey const& name() const { return m_name.get<PropertyKey>(); }
+    PrivateName const& private_name() const { return m_name.get<PrivateName>(); }
+    bool is_strict() const { return m_strict; }
+
+    // 6.2.4.2 IsUnresolvableReference ( V ), https://tc39.es/ecma262/#sec-isunresolvablereference
+    bool is_unresolvable() const { return m_base_type == BaseType::Unresolvable; }
+
+    // 6.2.4.1 IsPropertyReference ( V ), https://tc39.es/ecma262/#sec-ispropertyreference
+    bool is_property_reference() const
+    {
+        if (is_unresolvable())
+            return false;
+        if (m_base_type == BaseType::Environment)
+            return false;
+        return true;
+    }
+
+    // 6.2.4.7 GetThisValue ( V ), https://tc39.es/ecma262/#sec-getthisvalue
+    Value get_this_value() const
+    {
+        VERIFY(is_property_reference());
+        if (is_super_reference())
+            return m_this_value;
+        return m_base_value;
+    }
+
+    // 6.2.4.3 IsSuperReference ( V ), https://tc39.es/ecma262/#sec-issuperreference
+    bool is_super_reference() const
+    {
+        return !m_this_value.is_empty();
+    }
+
+    // 6.2.4.4 IsPrivateReference ( V ), https://tc39.es/ecma262/#sec-isprivatereference
+    bool is_private_reference() const
+    {
+        return m_name.has<PrivateName>();
+    }
+
+    // Note: Non-standard helper.
+    bool is_environment_reference() const
+    {
+        return m_base_type == BaseType::Environment;
+    }
+
+    ThrowCompletionOr<void> initialize_referenced_binding(VM&, Value value, Environment::InitializeBindingHint hint = Environment::InitializeBindingHint::Normal) const;
+
+    ThrowCompletionOr<void> put_value(VM&, Value);
+    ThrowCompletionOr<Value> get_value(VM&) const;
+    ThrowCompletionOr<bool> delete_(VM&);
+
+    bool is_valid_reference() const { return true; }
+
+    Optional<EnvironmentCoordinate> environment_coordinate() const { return m_environment_coordinate; }
+
+private:
+    Completion throw_reference_error(VM&) const;
+
+    BaseType m_base_type { BaseType::Unresolvable };
+    union {
+        Value m_base_value {};
+        mutable Environment* m_base_environment;
+    };
+    Variant<PropertyKey, PrivateName> m_name;
+    Value m_this_value;
+    bool m_strict { false };
+
+    Optional<EnvironmentCoordinate> m_environment_coordinate;
+};
+
+}