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-08-20 09:21:55 +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/CyclicModule.h
+++ b/Libraries/LibJS/CyclicModule.h
@ -0,0 +1,80 @@
+/*
+ * Copyright (c) 2022, David Tuin <davidot@serenityos.org>
+ * Copyright (c) 2023, networkException <networkexception@serenityos.org>
+ *
+ * SPDX-License-Identifier: BSD-2-Clause
+ */
+
+#pragma once
+
+#include <LibJS/Forward.h>
+#include <LibJS/Module.h>
+
+namespace JS {
+
+enum class ModuleStatus {
+    New,
+    Unlinked,
+    Linking,
+    Linked,
+    Evaluating,
+    EvaluatingAsync,
+    Evaluated
+};
+
+// 16.2.1.5 Cyclic Module Records, https://tc39.es/ecma262/#cyclic-module-record
+class CyclicModule : public Module {
+    JS_CELL(CyclicModule, Module);
+    JS_DECLARE_ALLOCATOR(CyclicModule);
+
+public:
+    virtual ~CyclicModule() override;
+
+    // Note: Do not call these methods directly unless you are HostResolveImportedModule.
+    //       Badges cannot be used because other hosts must be able to call this (and it is called recursively)
+    virtual ThrowCompletionOr<void> link(VM& vm) override final;
+    virtual ThrowCompletionOr<Promise*> evaluate(VM& vm) override final;
+
+    virtual PromiseCapability& load_requested_modules(GCPtr<GraphLoadingState::HostDefined>) override;
+    virtual void inner_module_loading(GraphLoadingState& state);
+
+    Vector<ModuleRequest> const& requested_modules() const { return m_requested_modules; }
+    Vector<ModuleWithSpecifier> const& loaded_modules() const { return m_loaded_modules; }
+    Vector<ModuleWithSpecifier>& loaded_modules() { return m_loaded_modules; }
+
+protected:
+    CyclicModule(Realm& realm, StringView filename, bool has_top_level_await, Vector<ModuleRequest> requested_modules, Script::HostDefined* host_defined);
+
+    virtual void visit_edges(Cell::Visitor&) override;
+
+    virtual ThrowCompletionOr<u32> inner_module_linking(VM& vm, Vector<Module*>& stack, u32 index) override final;
+    virtual ThrowCompletionOr<u32> inner_module_evaluation(VM& vm, Vector<Module*>& stack, u32 index) override final;
+
+    virtual ThrowCompletionOr<void> initialize_environment(VM& vm);
+    virtual ThrowCompletionOr<void> execute_module(VM& vm, GCPtr<PromiseCapability> capability = {});
+
+    [[nodiscard]] NonnullGCPtr<Module> get_imported_module(ModuleRequest const&);
+
+    void execute_async_module(VM& vm);
+    void gather_available_ancestors(Vector<CyclicModule*>& exec_list);
+    void async_module_execution_fulfilled(VM& vm);
+    void async_module_execution_rejected(VM& vm, Value error);
+
+    ModuleStatus m_status { ModuleStatus::New };        // [[Status]]
+    ThrowCompletionOr<void> m_evaluation_error;         // [[EvaluationError]]
+    Optional<u32> m_dfs_index;                          // [[DFSIndex]]
+    Optional<u32> m_dfs_ancestor_index;                 // [[DFSAncestorIndex]]
+    Vector<ModuleRequest> m_requested_modules;          // [[RequestedModules]]
+    Vector<ModuleWithSpecifier> m_loaded_modules;       // [[LoadedModules]]
+    GCPtr<CyclicModule> m_cycle_root;                   // [[CycleRoot]]
+    bool m_has_top_level_await { false };               // [[HasTLA]]
+    bool m_async_evaluation { false };                  // [[AsyncEvaluation]]
+    GCPtr<PromiseCapability> m_top_level_capability;    // [[TopLevelCapability]]
+    Vector<GCPtr<CyclicModule>> m_async_parent_modules; // [[AsyncParentModules]]
+    Optional<u32> m_pending_async_dependencies;         // [[PendingAsyncDependencies]]
+};
+
+void continue_module_loading(GraphLoadingState&, ThrowCompletionOr<NonnullGCPtr<Module>> const&);
+void continue_dynamic_import(NonnullGCPtr<PromiseCapability>, ThrowCompletionOr<NonnullGCPtr<Module>> const& module_completion);
+
+}