/* * Copyright (c) 2022, Andrew Kaster * * SPDX-License-Identifier: BSD-2-Clause */ #include #include #include #include #include #include #include #include #include static ErrorOr add_to_interface_sets(IDL::Interface&, Vector& intrinsics, Vector& window_exposed, Vector& dedicated_worker_exposed, Vector& shared_worker_exposed); static DeprecatedString s_error_string; struct LegacyConstructor { DeprecatedString name; DeprecatedString constructor_class; }; static void consume_whitespace(GenericLexer& lexer) { bool consumed = true; while (consumed) { consumed = lexer.consume_while(is_ascii_space).length() > 0; if (lexer.consume_specific("//")) { lexer.consume_until('\n'); lexer.ignore(); consumed = true; } } } static Optional const& lookup_legacy_constructor(IDL::Interface& interface) { static HashMap> s_legacy_constructors; if (auto cache = s_legacy_constructors.get(interface.name); cache.has_value()) return cache.value(); auto attribute = interface.extended_attributes.get("LegacyFactoryFunction"sv); if (!attribute.has_value()) { s_legacy_constructors.set(interface.name, {}); return s_legacy_constructors.get(interface.name).value(); } GenericLexer function_lexer(attribute.value()); consume_whitespace(function_lexer); auto name = function_lexer.consume_until([](auto ch) { return is_ascii_space(ch) || ch == '('; }); auto constructor_class = DeprecatedString::formatted("{}Constructor", name); s_legacy_constructors.set(interface.name, LegacyConstructor { name, move(constructor_class) }); return s_legacy_constructors.get(interface.name).value(); } static ErrorOr generate_forwarding_header(StringView output_path, Vector& exposed_interfaces) { StringBuilder builder; SourceGenerator generator(builder); generator.append(R"~~~( #pragma once namespace Web::Bindings { )~~~"); auto add_namespace = [](SourceGenerator& gen, StringView namespace_class) { gen.set("namespace_class", namespace_class); gen.append(R"~~~( class @namespace_class@;)~~~"); }; auto add_interface = [](SourceGenerator& gen, StringView prototype_class, StringView constructor_class, Optional const& legacy_constructor, StringView named_properties_class) { gen.set("prototype_class", prototype_class); gen.set("constructor_class", constructor_class); gen.append(R"~~~( class @prototype_class@; class @constructor_class@;)~~~"); if (legacy_constructor.has_value()) { gen.set("legacy_constructor_class", legacy_constructor->constructor_class); gen.append(R"~~~( class @legacy_constructor_class@;)~~~"); } if (!named_properties_class.is_empty()) { gen.set("named_properties_class", named_properties_class); gen.append(R"~~~( class @named_properties_class@;)~~~"); } }; for (auto& interface : exposed_interfaces) { auto gen = generator.fork(); String named_properties_class; if (interface.extended_attributes.contains("Global") && interface.supports_named_properties()) { named_properties_class = MUST(String::formatted("{}Properties", interface.name)); } if (interface.is_namespace) add_namespace(gen, interface.namespace_class); else add_interface(gen, interface.prototype_class, interface.constructor_class, lookup_legacy_constructor(interface), named_properties_class); } generator.append(R"~~~( } )~~~"); auto generated_forward_path = LexicalPath(output_path).append("Forward.h"sv).string(); auto generated_forward_file = TRY(Core::File::open(generated_forward_path, Core::File::OpenMode::Write)); TRY(generated_forward_file->write_until_depleted(generator.as_string_view().bytes())); return {}; } static ErrorOr generate_intrinsic_definitions(StringView output_path, Vector& exposed_interfaces) { StringBuilder builder; SourceGenerator generator(builder); generator.append(R"~~~( #include #include #include )~~~"); for (auto& interface : exposed_interfaces) { auto gen = generator.fork(); gen.set("namespace_class", interface.namespace_class); gen.set("prototype_class", interface.prototype_class); gen.set("constructor_class", interface.constructor_class); if (interface.is_namespace) { gen.append(R"~~~( #include )~~~"); } else { gen.append(R"~~~( #include #include )~~~"); if (auto const& legacy_constructor = lookup_legacy_constructor(interface); legacy_constructor.has_value()) { gen.set("legacy_constructor_class", legacy_constructor->constructor_class); gen.append(R"~~~( #include )~~~"); } } } generator.append(R"~~~( namespace Web::Bindings { )~~~"); auto add_namespace = [&](SourceGenerator& gen, StringView name, StringView namespace_class) { gen.set("interface_name", name); gen.set("namespace_class", namespace_class); gen.append(R"~~~( template<> void Intrinsics::create_web_namespace<@namespace_class@>(JS::Realm& realm) { auto namespace_object = heap().allocate<@namespace_class@>(realm, realm); m_namespaces.set("@interface_name@"sv, namespace_object); [[maybe_unused]] static constexpr u8 attr = JS::Attribute::Writable | JS::Attribute::Configurable;)~~~"); for (auto& interface : exposed_interfaces) { if (interface.extended_attributes.get("LegacyNamespace"sv) != name) continue; gen.set("owned_interface_name", interface.name); gen.set("owned_prototype_class", interface.prototype_class); gen.append(R"~~~( namespace_object->define_intrinsic_accessor("@owned_interface_name@", attr, [](auto& realm) -> JS::Value { return &Bindings::ensure_web_constructor<@owned_prototype_class@>(realm, "@interface_name@.@owned_interface_name@"sv); });)~~~"); } gen.append(R"~~~( } )~~~"); }; auto add_interface = [](SourceGenerator& gen, StringView name, StringView prototype_class, StringView constructor_class, Optional const& legacy_constructor, StringView named_properties_class) { gen.set("interface_name", name); gen.set("prototype_class", prototype_class); gen.set("constructor_class", constructor_class); gen.append(R"~~~( template<> void Intrinsics::create_web_prototype_and_constructor<@prototype_class@>(JS::Realm& realm) { auto& vm = realm.vm(); )~~~"); if (!named_properties_class.is_empty()) { gen.set("named_properties_class", named_properties_class); gen.append(R"~~~( auto named_properties_object = heap().allocate<@named_properties_class@>(realm, realm); m_prototypes.set("@named_properties_class@"sv, named_properties_object); )~~~"); } gen.append(R"~~~( auto prototype = heap().allocate<@prototype_class@>(realm, realm); m_prototypes.set("@interface_name@"sv, prototype); auto constructor = heap().allocate<@constructor_class@>(realm, realm); m_constructors.set("@interface_name@"sv, constructor); prototype->define_direct_property(vm.names.constructor, constructor.ptr(), JS::Attribute::Writable | JS::Attribute::Configurable); constructor->define_direct_property(vm.names.name, JS::PrimitiveString::create(vm, "@interface_name@"_string), JS::Attribute::Configurable); )~~~"); if (legacy_constructor.has_value()) { gen.set("legacy_interface_name", legacy_constructor->name); gen.set("legacy_constructor_class", legacy_constructor->constructor_class); gen.append(R"~~~( auto legacy_constructor = heap().allocate<@legacy_constructor_class@>(realm, realm); m_constructors.set("@legacy_interface_name@"sv, legacy_constructor); legacy_constructor->define_direct_property(vm.names.name, JS::PrimitiveString::create(vm, "@legacy_interface_name@"_string), JS::Attribute::Configurable);)~~~"); } gen.append(R"~~~( } )~~~"); }; for (auto& interface : exposed_interfaces) { auto gen = generator.fork(); String named_properties_class; if (interface.extended_attributes.contains("Global") && interface.supports_named_properties()) { named_properties_class = MUST(String::formatted("{}Properties", interface.name)); } if (interface.is_namespace) add_namespace(gen, interface.name, interface.namespace_class); else add_interface(gen, interface.namespaced_name, interface.prototype_class, interface.constructor_class, lookup_legacy_constructor(interface), named_properties_class); } generator.append(R"~~~( } )~~~"); auto generated_intrinsics_path = LexicalPath(output_path).append("IntrinsicDefinitions.cpp"sv).string(); auto generated_intrinsics_file = TRY(Core::File::open(generated_intrinsics_path, Core::File::OpenMode::Write)); TRY(generated_intrinsics_file->write_until_depleted(generator.as_string_view().bytes())); return {}; } static ErrorOr generate_exposed_interface_header(StringView class_name, StringView output_path) { StringBuilder builder; SourceGenerator generator(builder); generator.set("global_object_snake_name", DeprecatedString(class_name).to_snakecase()); generator.append(R"~~~( #pragma once #include namespace Web::Bindings { void add_@global_object_snake_name@_exposed_interfaces(JS::Object&); } )~~~"); auto generated_header_path = LexicalPath(output_path).append(DeprecatedString::formatted("{}ExposedInterfaces.h", class_name)).string(); auto generated_header_file = TRY(Core::File::open(generated_header_path, Core::File::OpenMode::Write)); TRY(generated_header_file->write_until_depleted(generator.as_string_view().bytes())); return {}; } static ErrorOr generate_exposed_interface_implementation(StringView class_name, StringView output_path, Vector& exposed_interfaces) { StringBuilder builder; SourceGenerator generator(builder); generator.set("global_object_name", class_name); generator.set("global_object_snake_name", DeprecatedString(class_name).to_snakecase()); generator.append(R"~~~( #include #include #include )~~~"); for (auto& interface : exposed_interfaces) { auto gen = generator.fork(); gen.set("namespace_class", interface.namespace_class); gen.set("prototype_class", interface.prototype_class); gen.set("constructor_class", interface.constructor_class); if (interface.is_namespace) { gen.append(R"~~~(#include )~~~"); } else { gen.append(R"~~~(#include #include )~~~"); if (auto const& legacy_constructor = lookup_legacy_constructor(interface); legacy_constructor.has_value()) { gen.set("legacy_constructor_class", legacy_constructor->constructor_class); gen.append(R"~~~(#include )~~~"); } } } generator.append(R"~~~( namespace Web::Bindings { void add_@global_object_snake_name@_exposed_interfaces(JS::Object& global) { static constexpr u8 attr = JS::Attribute::Writable | JS::Attribute::Configurable; )~~~"); auto add_interface = [](SourceGenerator& gen, StringView name, StringView prototype_class, Optional const& legacy_constructor) { gen.set("interface_name", name); gen.set("prototype_class", prototype_class); gen.append(R"~~~( global.define_intrinsic_accessor("@interface_name@", attr, [](auto& realm) -> JS::Value { return &ensure_web_constructor<@prototype_class@>(realm, "@interface_name@"sv); });)~~~"); if (legacy_constructor.has_value()) { gen.set("legacy_interface_name", legacy_constructor->name); gen.append(R"~~~( global.define_intrinsic_accessor("@legacy_interface_name@", attr, [](auto& realm) -> JS::Value { return &ensure_web_constructor<@prototype_class@>(realm, "@legacy_interface_name@"sv); });)~~~"); } }; auto add_namespace = [](SourceGenerator& gen, StringView name, StringView namespace_class) { gen.set("interface_name", name); gen.set("namespace_class", namespace_class); gen.append(R"~~~( global.define_intrinsic_accessor("@interface_name@", attr, [](auto& realm) -> JS::Value { return &ensure_web_namespace<@namespace_class@>(realm, "@interface_name@"sv); });)~~~"); }; for (auto& interface : exposed_interfaces) { auto gen = generator.fork(); if (interface.is_namespace) add_namespace(gen, interface.name, interface.namespace_class); else if (!interface.extended_attributes.contains("LegacyNamespace"sv)) add_interface(gen, interface.namespaced_name, interface.prototype_class, lookup_legacy_constructor(interface)); } generator.append(R"~~~( } } )~~~"); auto generated_implementation_path = LexicalPath(output_path).append(DeprecatedString::formatted("{}ExposedInterfaces.cpp", class_name)).string(); auto generated_implementation_file = TRY(Core::File::open(generated_implementation_path, Core::File::OpenMode::Write)); TRY(generated_implementation_file->write_until_depleted(generator.as_string_view().bytes())); return {}; } ErrorOr serenity_main(Main::Arguments arguments) { Core::ArgsParser args_parser; StringView output_path; StringView base_path; Vector paths; args_parser.add_option(output_path, "Path to output generated files into", "output-path", 'o', "output-path"); args_parser.add_option(base_path, "Path to root of IDL file tree", "base-path", 'b', "base-path"); args_parser.add_positional_argument(paths, "Paths of every IDL file that could be Exposed", "paths"); args_parser.parse(arguments); VERIFY(!paths.is_empty()); VERIFY(!base_path.is_empty()); const LexicalPath lexical_base(base_path); // Read in all IDL files, we must own the storage for all of these for the lifetime of the program Vector file_contents; for (DeprecatedString const& path : paths) { auto file_or_error = Core::File::open(path, Core::File::OpenMode::Read); if (file_or_error.is_error()) { s_error_string = DeprecatedString::formatted("Unable to open file {}", path); return Error::from_string_view(s_error_string.view()); } auto file = file_or_error.release_value(); auto string = MUST(file->read_until_eof()); file_contents.append(DeprecatedString(ReadonlyBytes(string))); } VERIFY(paths.size() == file_contents.size()); Vector parsers; Vector intrinsics; Vector window_exposed; Vector dedicated_worker_exposed; Vector shared_worker_exposed; // TODO: service_worker_exposed for (size_t i = 0; i < paths.size(); ++i) { IDL::Parser parser(paths[i], file_contents[i], lexical_base.string()); TRY(add_to_interface_sets(parser.parse(), intrinsics, window_exposed, dedicated_worker_exposed, shared_worker_exposed)); parsers.append(move(parser)); } TRY(generate_forwarding_header(output_path, intrinsics)); TRY(generate_intrinsic_definitions(output_path, intrinsics)); TRY(generate_exposed_interface_header("Window"sv, output_path)); TRY(generate_exposed_interface_header("DedicatedWorker"sv, output_path)); TRY(generate_exposed_interface_header("SharedWorker"sv, output_path)); // TODO: ServiceWorkerExposed.h TRY(generate_exposed_interface_implementation("Window"sv, output_path, window_exposed)); TRY(generate_exposed_interface_implementation("DedicatedWorker"sv, output_path, dedicated_worker_exposed)); TRY(generate_exposed_interface_implementation("SharedWorker"sv, output_path, shared_worker_exposed)); // TODO: ServiceWorkerExposed.cpp return 0; } enum ExposedTo { Nobody = 0x0, DedicatedWorker = 0x1, SharedWorker = 0x2, ServiceWorker = 0x4, AudioWorklet = 0x8, Window = 0x10, AllWorkers = 0xF, // FIXME: Is "AudioWorklet" a Worker? We'll assume it is for now All = 0x1F, }; AK_ENUM_BITWISE_OPERATORS(ExposedTo); static ErrorOr parse_exposure_set(IDL::Interface& interface) { // NOTE: This roughly follows the definitions of https://webidl.spec.whatwg.org/#Exposed // It does not remotely interpret all the abstract operations therein though. auto maybe_exposed = interface.extended_attributes.get("Exposed"); if (!maybe_exposed.has_value()) { s_error_string = DeprecatedString::formatted("Interface {} is missing extended attribute Exposed", interface.name); return Error::from_string_view(s_error_string.view()); } auto exposed = maybe_exposed.value().trim_whitespace(); if (exposed == "*"sv) return ExposedTo::All; if (exposed == "Nobody"sv) return ExposedTo::Nobody; if (exposed == "Window"sv) return ExposedTo::Window; if (exposed == "Worker"sv) return ExposedTo::AllWorkers; if (exposed == "AudioWorklet"sv) return ExposedTo::AudioWorklet; if (exposed[0] == '(') { ExposedTo whom = Nobody; for (StringView candidate : exposed.substring_view(1, exposed.length() - 1).split_view(',')) { candidate = candidate.trim_whitespace(); if (candidate == "Window"sv) { whom |= ExposedTo::Window; } else if (candidate == "Worker"sv) { whom |= ExposedTo::AllWorkers; } else if (candidate == "DedicatedWorker"sv) { whom |= ExposedTo::DedicatedWorker; } else if (candidate == "SharedWorker"sv) { whom |= ExposedTo::SharedWorker; } else if (candidate == "ServiceWorker"sv) { whom |= ExposedTo::ServiceWorker; } else if (candidate == "AudioWorklet"sv) { whom |= ExposedTo::AudioWorklet; } else { s_error_string = DeprecatedString::formatted("Unknown Exposed attribute candidate {} in {} in {}", candidate, exposed, interface.name); return Error::from_string_view(s_error_string.view()); } } if (whom == ExposedTo::Nobody) { s_error_string = DeprecatedString::formatted("Unknown Exposed attribute {} in {}", exposed, interface.name); return Error::from_string_view(s_error_string.view()); } return whom; } s_error_string = DeprecatedString::formatted("Unknown Exposed attribute {} in {}", exposed, interface.name); return Error::from_string_view(s_error_string.view()); } ErrorOr add_to_interface_sets(IDL::Interface& interface, Vector& intrinsics, Vector& window_exposed, Vector& dedicated_worker_exposed, Vector& shared_worker_exposed) { // TODO: Add service worker exposed and audio worklet exposed auto whom = TRY(parse_exposure_set(interface)); intrinsics.append(interface); if (whom & ExposedTo::Window) window_exposed.append(interface); if (whom & ExposedTo::DedicatedWorker) dedicated_worker_exposed.append(interface); if (whom & ExposedTo::SharedWorker) shared_worker_exposed.append(interface); return {}; }