GenerateCSSPropertyID.cpp 36 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998
  1. /*
  2. * Copyright (c) 2018-2020, Andreas Kling <kling@serenityos.org>
  3. * Copyright (c) 2021-2023, Sam Atkins <atkinssj@serenityos.org>
  4. *
  5. * SPDX-License-Identifier: BSD-2-Clause
  6. */
  7. #include "GeneratorUtil.h"
  8. #include <AK/CharacterTypes.h>
  9. #include <AK/GenericShorthands.h>
  10. #include <AK/SourceGenerator.h>
  11. #include <AK/StringBuilder.h>
  12. #include <LibCore/ArgsParser.h>
  13. #include <LibMain/Main.h>
  14. void replace_logical_aliases(JsonObject& properties);
  15. ErrorOr<void> generate_header_file(JsonObject& properties, Core::File& file);
  16. ErrorOr<void> generate_implementation_file(JsonObject& properties, Core::File& file);
  17. void generate_bounds_checking_function(JsonObject& properties, SourceGenerator& parent_generator, StringView css_type_name, StringView type_name, Optional<StringView> default_unit_name = {}, Optional<StringView> value_getter = {});
  18. bool is_animatable_property(JsonObject& properties, StringView property_name);
  19. static bool type_name_is_enum(StringView type_name)
  20. {
  21. return !AK::first_is_one_of(type_name,
  22. "angle"sv, "background-position"sv, "basic-shape"sv, "color"sv, "custom-ident"sv, "easing-function"sv, "flex"sv, "frequency"sv, "image"sv,
  23. "integer"sv, "length"sv, "number"sv, "paint"sv, "percentage"sv, "position"sv, "ratio"sv, "rect"sv,
  24. "resolution"sv, "string"sv, "time"sv, "url"sv);
  25. }
  26. ErrorOr<int> serenity_main(Main::Arguments arguments)
  27. {
  28. StringView generated_header_path;
  29. StringView generated_implementation_path;
  30. StringView properties_json_path;
  31. Core::ArgsParser args_parser;
  32. args_parser.add_option(generated_header_path, "Path to the PropertyID header file to generate", "generated-header-path", 'h', "generated-header-path");
  33. args_parser.add_option(generated_implementation_path, "Path to the PropertyID implementation file to generate", "generated-implementation-path", 'c', "generated-implementation-path");
  34. args_parser.add_option(properties_json_path, "Path to the JSON file to read from", "json-path", 'j', "json-path");
  35. args_parser.parse(arguments);
  36. auto json = TRY(read_entire_file_as_json(properties_json_path));
  37. VERIFY(json.is_object());
  38. auto properties = json.as_object();
  39. // Check we're in alphabetical order
  40. ByteString most_recent_name = "";
  41. properties.for_each_member([&](auto& name, auto&) {
  42. if (name < most_recent_name) {
  43. warnln("`{}` is in the wrong position in `{}`. Please keep this list alphabetical!", name, properties_json_path);
  44. VERIFY_NOT_REACHED();
  45. }
  46. most_recent_name = name;
  47. });
  48. replace_logical_aliases(properties);
  49. auto generated_header_file = TRY(Core::File::open(generated_header_path, Core::File::OpenMode::Write));
  50. auto generated_implementation_file = TRY(Core::File::open(generated_implementation_path, Core::File::OpenMode::Write));
  51. TRY(generate_header_file(properties, *generated_header_file));
  52. TRY(generate_implementation_file(properties, *generated_implementation_file));
  53. return 0;
  54. }
  55. void replace_logical_aliases(JsonObject& properties)
  56. {
  57. AK::HashMap<ByteString, ByteString> logical_aliases;
  58. properties.for_each_member([&](auto& name, auto& value) {
  59. VERIFY(value.is_object());
  60. auto const& value_as_object = value.as_object();
  61. auto const logical_alias_for = value_as_object.get_array("logical-alias-for"sv);
  62. if (logical_alias_for.has_value()) {
  63. auto const& aliased_properties = logical_alias_for.value();
  64. for (auto const& aliased_property : aliased_properties.values()) {
  65. logical_aliases.set(name, aliased_property.as_string());
  66. }
  67. }
  68. });
  69. for (auto& [name, alias] : logical_aliases) {
  70. auto const maybe_alias_object = properties.get_object(alias);
  71. if (!maybe_alias_object.has_value()) {
  72. dbgln("No property '{}' found for logical alias '{}'", alias, name);
  73. VERIFY_NOT_REACHED();
  74. }
  75. JsonObject alias_object = maybe_alias_object.value();
  76. // Copy over anything the logical property overrides
  77. properties.get_object(name).value().for_each_member([&](auto& key, auto& value) {
  78. alias_object.set(key, value);
  79. });
  80. properties.set(name, alias_object);
  81. }
  82. }
  83. ErrorOr<void> generate_header_file(JsonObject& properties, Core::File& file)
  84. {
  85. StringBuilder builder;
  86. SourceGenerator generator { builder };
  87. generator.append(R"~~~(
  88. #pragma once
  89. #include <AK/NonnullRefPtr.h>
  90. #include <AK/StringView.h>
  91. #include <AK/Traits.h>
  92. #include <LibJS/Forward.h>
  93. #include <LibWeb/Forward.h>
  94. namespace Web::CSS {
  95. enum class PropertyID {
  96. Invalid,
  97. Custom,
  98. All,
  99. )~~~");
  100. Vector<ByteString> shorthand_property_ids;
  101. Vector<ByteString> longhand_property_ids;
  102. properties.for_each_member([&](auto& name, auto& value) {
  103. VERIFY(value.is_object());
  104. if (value.as_object().has("longhands"sv))
  105. shorthand_property_ids.append(name);
  106. else
  107. longhand_property_ids.append(name);
  108. });
  109. auto first_property_id = shorthand_property_ids.first();
  110. auto last_property_id = longhand_property_ids.last();
  111. for (auto& name : shorthand_property_ids) {
  112. auto member_generator = generator.fork();
  113. member_generator.set("name:titlecase", title_casify(name));
  114. member_generator.append(R"~~~(
  115. @name:titlecase@,
  116. )~~~");
  117. }
  118. for (auto& name : longhand_property_ids) {
  119. auto member_generator = generator.fork();
  120. member_generator.set("name:titlecase", title_casify(name));
  121. member_generator.append(R"~~~(
  122. @name:titlecase@,
  123. )~~~");
  124. }
  125. generator.set("first_property_id", title_casify(first_property_id));
  126. generator.set("last_property_id", title_casify(last_property_id));
  127. generator.set("first_shorthand_property_id", title_casify(shorthand_property_ids.first()));
  128. generator.set("last_shorthand_property_id", title_casify(shorthand_property_ids.last()));
  129. generator.set("first_longhand_property_id", title_casify(longhand_property_ids.first()));
  130. generator.set("last_longhand_property_id", title_casify(longhand_property_ids.last()));
  131. generator.append(R"~~~(
  132. };
  133. enum class AnimationType {
  134. Discrete,
  135. ByComputedValue,
  136. RepeatableList,
  137. Custom,
  138. None,
  139. };
  140. AnimationType animation_type_from_longhand_property(PropertyID);
  141. bool is_animatable_property(PropertyID);
  142. Optional<PropertyID> property_id_from_camel_case_string(StringView);
  143. Optional<PropertyID> property_id_from_string(StringView);
  144. [[nodiscard]] FlyString const& string_from_property_id(PropertyID);
  145. [[nodiscard]] FlyString const& camel_case_string_from_property_id(PropertyID);
  146. bool is_inherited_property(PropertyID);
  147. NonnullRefPtr<StyleValue> property_initial_value(JS::Realm&, PropertyID);
  148. enum class ValueType {
  149. Angle,
  150. BackgroundPosition,
  151. BasicShape,
  152. Color,
  153. CustomIdent,
  154. EasingFunction,
  155. FilterValueList,
  156. Flex,
  157. Frequency,
  158. Image,
  159. Integer,
  160. Length,
  161. Number,
  162. Paint,
  163. Percentage,
  164. Position,
  165. Ratio,
  166. Rect,
  167. Resolution,
  168. String,
  169. Time,
  170. Url,
  171. };
  172. bool property_accepts_type(PropertyID, ValueType);
  173. bool property_accepts_identifier(PropertyID, ValueID);
  174. Optional<ValueType> property_resolves_percentages_relative_to(PropertyID);
  175. // These perform range-checking, but are also safe to call with properties that don't accept that type. (They'll just return false.)
  176. bool property_accepts_angle(PropertyID, Angle const&);
  177. bool property_accepts_flex(PropertyID, Flex const&);
  178. bool property_accepts_frequency(PropertyID, Frequency const&);
  179. bool property_accepts_integer(PropertyID, i64 const&);
  180. bool property_accepts_length(PropertyID, Length const&);
  181. bool property_accepts_number(PropertyID, double const&);
  182. bool property_accepts_percentage(PropertyID, Percentage const&);
  183. bool property_accepts_resolution(PropertyID, Resolution const&);
  184. bool property_accepts_time(PropertyID, Time const&);
  185. bool property_is_shorthand(PropertyID);
  186. Vector<PropertyID> longhands_for_shorthand(PropertyID);
  187. size_t property_maximum_value_count(PropertyID);
  188. bool property_affects_layout(PropertyID);
  189. bool property_affects_stacking_context(PropertyID);
  190. constexpr PropertyID first_property_id = PropertyID::@first_property_id@;
  191. constexpr PropertyID last_property_id = PropertyID::@last_property_id@;
  192. constexpr PropertyID first_shorthand_property_id = PropertyID::@first_shorthand_property_id@;
  193. constexpr PropertyID last_shorthand_property_id = PropertyID::@last_shorthand_property_id@;
  194. constexpr PropertyID first_longhand_property_id = PropertyID::@first_longhand_property_id@;
  195. constexpr PropertyID last_longhand_property_id = PropertyID::@last_longhand_property_id@;
  196. enum class Quirk {
  197. // https://quirks.spec.whatwg.org/#the-hashless-hex-color-quirk
  198. HashlessHexColor,
  199. // https://quirks.spec.whatwg.org/#the-unitless-length-quirk
  200. UnitlessLength,
  201. };
  202. bool property_has_quirk(PropertyID, Quirk);
  203. } // namespace Web::CSS
  204. namespace AK {
  205. template<>
  206. struct Traits<Web::CSS::PropertyID> : public DefaultTraits<Web::CSS::PropertyID> {
  207. static unsigned hash(Web::CSS::PropertyID property_id) { return int_hash((unsigned)property_id); }
  208. };
  209. } // namespace AK
  210. )~~~");
  211. TRY(file.write_until_depleted(generator.as_string_view().bytes()));
  212. return {};
  213. }
  214. void generate_bounds_checking_function(JsonObject& properties, SourceGenerator& parent_generator, StringView css_type_name, StringView type_name, Optional<StringView> default_unit_name, Optional<StringView> value_getter)
  215. {
  216. auto generator = parent_generator.fork();
  217. generator.set("css_type_name", css_type_name);
  218. generator.set("type_name", type_name);
  219. generator.append(R"~~~(
  220. bool property_accepts_@css_type_name@(PropertyID property_id, [[maybe_unused]] @type_name@ const& value)
  221. {
  222. switch (property_id) {
  223. )~~~");
  224. properties.for_each_member([&](auto& name, JsonValue const& value) -> void {
  225. VERIFY(value.is_object());
  226. if (auto maybe_valid_types = value.as_object().get_array("valid-types"sv); maybe_valid_types.has_value() && !maybe_valid_types->is_empty()) {
  227. for (auto valid_type : maybe_valid_types->values()) {
  228. auto type_and_range = valid_type.as_string().split_view(' ');
  229. if (type_and_range.first() != css_type_name)
  230. continue;
  231. auto property_generator = generator.fork();
  232. property_generator.set("property_name:titlecase", title_casify(name));
  233. property_generator.append(R"~~~(
  234. case PropertyID::@property_name:titlecase@:
  235. return )~~~");
  236. if (type_and_range.size() > 1) {
  237. auto range = type_and_range[1];
  238. VERIFY(range.starts_with('[') && range.ends_with(']') && range.contains(','));
  239. auto comma_index = range.find(',').value();
  240. StringView min_value_string = range.substring_view(1, comma_index - 1);
  241. StringView max_value_string = range.substring_view(comma_index + 1, range.length() - comma_index - 2);
  242. // If the min/max value is infinite, we can just skip that side of the check.
  243. if (min_value_string == "-∞")
  244. min_value_string = {};
  245. if (max_value_string == "∞")
  246. max_value_string = {};
  247. if (min_value_string.is_empty() && max_value_string.is_empty()) {
  248. property_generator.appendln("true;");
  249. break;
  250. }
  251. auto output_check = [&](auto& value_string, StringView comparator) {
  252. if (value_getter.has_value()) {
  253. property_generator.set("value_number", value_string);
  254. property_generator.set("value_getter", value_getter.value());
  255. property_generator.set("comparator", comparator);
  256. property_generator.append("@value_getter@ @comparator@ @value_number@");
  257. return;
  258. }
  259. GenericLexer lexer { value_string };
  260. auto value_number = lexer.consume_until(is_ascii_alpha);
  261. auto value_unit = lexer.consume_while(is_ascii_alpha);
  262. if (value_unit.is_empty())
  263. value_unit = default_unit_name.value();
  264. VERIFY(lexer.is_eof());
  265. property_generator.set("value_number", value_number);
  266. property_generator.set("value_unit", title_casify(value_unit));
  267. property_generator.set("comparator", comparator);
  268. property_generator.append("value @comparator@ @type_name@(@value_number@, @type_name@::Type::@value_unit@)");
  269. };
  270. if (!min_value_string.is_empty())
  271. output_check(min_value_string, ">="sv);
  272. if (!min_value_string.is_empty() && !max_value_string.is_empty())
  273. property_generator.append(" && ");
  274. if (!max_value_string.is_empty())
  275. output_check(max_value_string, "<="sv);
  276. property_generator.appendln(";");
  277. } else {
  278. property_generator.appendln("true;");
  279. }
  280. break;
  281. }
  282. }
  283. });
  284. generator.append(R"~~~(
  285. default:
  286. return false;
  287. }
  288. }
  289. )~~~");
  290. }
  291. ErrorOr<void> generate_implementation_file(JsonObject& properties, Core::File& file)
  292. {
  293. StringBuilder builder;
  294. SourceGenerator generator { builder };
  295. generator.append(R"~~~(
  296. #include <AK/Assertions.h>
  297. #include <LibWeb/CSS/Enums.h>
  298. #include <LibWeb/CSS/Parser/Parser.h>
  299. #include <LibWeb/CSS/PropertyID.h>
  300. #include <LibWeb/CSS/StyleValue.h>
  301. #include <LibWeb/CSS/StyleValues/PercentageStyleValue.h>
  302. #include <LibWeb/CSS/StyleValues/TimeStyleValue.h>
  303. #include <LibWeb/Infra/Strings.h>
  304. namespace Web::CSS {
  305. Optional<PropertyID> property_id_from_camel_case_string(StringView string)
  306. {
  307. )~~~");
  308. properties.for_each_member([&](auto& name, auto& value) {
  309. VERIFY(value.is_object());
  310. auto member_generator = generator.fork();
  311. member_generator.set("name", name);
  312. member_generator.set("name:titlecase", title_casify(name));
  313. member_generator.set("name:camelcase", camel_casify(name));
  314. member_generator.append(R"~~~(
  315. if (string.equals_ignoring_ascii_case("@name:camelcase@"sv))
  316. return PropertyID::@name:titlecase@;
  317. )~~~");
  318. });
  319. generator.append(R"~~~(
  320. return {};
  321. }
  322. Optional<PropertyID> property_id_from_string(StringView string)
  323. {
  324. if (Infra::is_ascii_case_insensitive_match(string, "all"sv))
  325. return PropertyID::All;
  326. )~~~");
  327. properties.for_each_member([&](auto& name, auto& value) {
  328. VERIFY(value.is_object());
  329. auto member_generator = generator.fork();
  330. member_generator.set("name", name);
  331. member_generator.set("name:titlecase", title_casify(name));
  332. member_generator.append(R"~~~(
  333. if (Infra::is_ascii_case_insensitive_match(string, "@name@"sv))
  334. return PropertyID::@name:titlecase@;
  335. )~~~");
  336. });
  337. generator.append(R"~~~(
  338. return {};
  339. }
  340. FlyString const& string_from_property_id(PropertyID property_id) {
  341. switch (property_id) {
  342. )~~~");
  343. properties.for_each_member([&](auto& name, auto& value) {
  344. VERIFY(value.is_object());
  345. auto member_generator = generator.fork();
  346. member_generator.set("name", name);
  347. member_generator.set("name:titlecase", title_casify(name));
  348. member_generator.append(R"~~~(
  349. case PropertyID::@name:titlecase@: {
  350. static FlyString name = "@name@"_fly_string;
  351. return name;
  352. }
  353. )~~~");
  354. });
  355. generator.append(R"~~~(
  356. default: {
  357. static FlyString invalid_property_id_string = "(invalid CSS::PropertyID)"_fly_string;
  358. return invalid_property_id_string;
  359. }
  360. }
  361. }
  362. FlyString const& camel_case_string_from_property_id(PropertyID property_id) {
  363. switch (property_id) {
  364. )~~~");
  365. properties.for_each_member([&](auto& name, auto& value) {
  366. VERIFY(value.is_object());
  367. auto member_generator = generator.fork();
  368. member_generator.set("name", name);
  369. member_generator.set("name:titlecase", title_casify(name));
  370. member_generator.set("name:camelcase", camel_casify(name));
  371. member_generator.append(R"~~~(
  372. case PropertyID::@name:titlecase@: {
  373. static FlyString name = "@name:camelcase@"_fly_string;
  374. return name;
  375. }
  376. )~~~");
  377. });
  378. generator.append(R"~~~(
  379. default: {
  380. static FlyString invalid_property_id_string = "(invalid CSS::PropertyID)"_fly_string;
  381. return invalid_property_id_string;
  382. }
  383. }
  384. }
  385. AnimationType animation_type_from_longhand_property(PropertyID property_id)
  386. {
  387. switch (property_id) {
  388. )~~~");
  389. properties.for_each_member([&](auto& name, auto& value) {
  390. VERIFY(value.is_object());
  391. auto member_generator = generator.fork();
  392. member_generator.set("name:titlecase", title_casify(name));
  393. // Shorthand properties should have already been expanded before calling into this function
  394. if (value.as_object().has("longhands"sv)) {
  395. if (value.as_object().has("animation-type"sv)) {
  396. dbgln("Property '{}' with longhands cannot specify 'animation-type'", name);
  397. VERIFY_NOT_REACHED();
  398. }
  399. member_generator.append(R"~~~(
  400. case PropertyID::@name:titlecase@:
  401. VERIFY_NOT_REACHED();
  402. )~~~");
  403. return;
  404. }
  405. if (!value.as_object().has("animation-type"sv)) {
  406. dbgln("No animation-type specified for property '{}'", name);
  407. VERIFY_NOT_REACHED();
  408. }
  409. auto animation_type = value.as_object().get_byte_string("animation-type"sv).value();
  410. member_generator.set("value", title_casify(animation_type));
  411. member_generator.append(R"~~~(
  412. case PropertyID::@name:titlecase@:
  413. return AnimationType::@value@;
  414. )~~~");
  415. });
  416. generator.append(R"~~~(
  417. default:
  418. return AnimationType::None;
  419. }
  420. }
  421. bool is_animatable_property(PropertyID property_id)
  422. {
  423. switch (property_id) {
  424. )~~~");
  425. properties.for_each_member([&](auto& name, auto& value) {
  426. VERIFY(value.is_object());
  427. if (is_animatable_property(properties, name)) {
  428. auto member_generator = generator.fork();
  429. member_generator.set("name:titlecase", title_casify(name));
  430. member_generator.append(R"~~~(
  431. case PropertyID::@name:titlecase@:
  432. )~~~");
  433. }
  434. });
  435. generator.append(R"~~~(
  436. return true;
  437. default:
  438. return false;
  439. }
  440. }
  441. bool is_inherited_property(PropertyID property_id)
  442. {
  443. switch (property_id) {
  444. )~~~");
  445. properties.for_each_member([&](auto& name, auto& value) {
  446. VERIFY(value.is_object());
  447. bool inherited = false;
  448. if (value.as_object().has("inherited"sv)) {
  449. auto inherited_value = value.as_object().get_bool("inherited"sv);
  450. VERIFY(inherited_value.has_value());
  451. inherited = inherited_value.value();
  452. }
  453. if (inherited) {
  454. auto member_generator = generator.fork();
  455. member_generator.set("name:titlecase", title_casify(name));
  456. member_generator.append(R"~~~(
  457. case PropertyID::@name:titlecase@:
  458. return true;
  459. )~~~");
  460. }
  461. });
  462. generator.append(R"~~~(
  463. default:
  464. return false;
  465. }
  466. }
  467. bool property_affects_layout(PropertyID property_id)
  468. {
  469. switch (property_id) {
  470. )~~~");
  471. properties.for_each_member([&](auto& name, auto& value) {
  472. VERIFY(value.is_object());
  473. bool affects_layout = true;
  474. if (value.as_object().has("affects-layout"sv))
  475. affects_layout = value.as_object().get_bool("affects-layout"sv).value_or(false);
  476. if (affects_layout) {
  477. auto member_generator = generator.fork();
  478. member_generator.set("name:titlecase", title_casify(name));
  479. member_generator.append(R"~~~(
  480. case PropertyID::@name:titlecase@:
  481. )~~~");
  482. }
  483. });
  484. generator.append(R"~~~(
  485. return true;
  486. default:
  487. return false;
  488. }
  489. }
  490. bool property_affects_stacking_context(PropertyID property_id)
  491. {
  492. switch (property_id) {
  493. )~~~");
  494. properties.for_each_member([&](auto& name, auto& value) {
  495. VERIFY(value.is_object());
  496. bool affects_stacking_context = false;
  497. if (value.as_object().has("affects-stacking-context"sv))
  498. affects_stacking_context = value.as_object().get_bool("affects-stacking-context"sv).value_or(false);
  499. if (affects_stacking_context) {
  500. auto member_generator = generator.fork();
  501. member_generator.set("name:titlecase", title_casify(name));
  502. member_generator.append(R"~~~(
  503. case PropertyID::@name:titlecase@:
  504. )~~~");
  505. }
  506. });
  507. generator.append(R"~~~(
  508. return true;
  509. default:
  510. return false;
  511. }
  512. }
  513. NonnullRefPtr<StyleValue> property_initial_value(JS::Realm& context_realm, PropertyID property_id)
  514. {
  515. static Array<RefPtr<StyleValue>, to_underlying(last_property_id) + 1> initial_values;
  516. if (auto initial_value = initial_values[to_underlying(property_id)])
  517. return initial_value.release_nonnull();
  518. // Lazily parse initial values as needed.
  519. // This ensures the shorthands will always be able to get the initial values of their longhands.
  520. // This also now allows a longhand have its own longhand (like background-position-x).
  521. Parser::ParsingContext parsing_context(context_realm);
  522. switch (property_id) {
  523. )~~~");
  524. auto output_initial_value_code = [&](auto& name, auto& object) {
  525. if (!object.has("initial"sv)) {
  526. dbgln("No initial value specified for property '{}'", name);
  527. VERIFY_NOT_REACHED();
  528. }
  529. auto initial_value = object.get_byte_string("initial"sv);
  530. VERIFY(initial_value.has_value());
  531. auto& initial_value_string = initial_value.value();
  532. auto member_generator = generator.fork();
  533. member_generator.set("name:titlecase", title_casify(name));
  534. member_generator.set("initial_value_string", initial_value_string);
  535. member_generator.append(
  536. R"~~~( case PropertyID::@name:titlecase@:
  537. {
  538. auto parsed_value = parse_css_value(parsing_context, "@initial_value_string@"sv, PropertyID::@name:titlecase@);
  539. VERIFY(!parsed_value.is_null());
  540. auto initial_value = parsed_value.release_nonnull();
  541. initial_values[to_underlying(PropertyID::@name:titlecase@)] = initial_value;
  542. return initial_value;
  543. }
  544. )~~~");
  545. };
  546. properties.for_each_member([&](auto& name, auto& value) {
  547. VERIFY(value.is_object());
  548. output_initial_value_code(name, value.as_object());
  549. });
  550. generator.append(
  551. R"~~~( default: VERIFY_NOT_REACHED();
  552. }
  553. VERIFY_NOT_REACHED();
  554. }
  555. bool property_has_quirk(PropertyID property_id, Quirk quirk)
  556. {
  557. switch (property_id) {
  558. )~~~");
  559. properties.for_each_member([&](auto& name, auto& value) {
  560. VERIFY(value.is_object());
  561. if (value.as_object().has("quirks"sv)) {
  562. auto quirks_value = value.as_object().get_array("quirks"sv);
  563. VERIFY(quirks_value.has_value());
  564. auto& quirks = quirks_value.value();
  565. if (!quirks.is_empty()) {
  566. auto property_generator = generator.fork();
  567. property_generator.set("name:titlecase", title_casify(name));
  568. property_generator.append(R"~~~(
  569. case PropertyID::@name:titlecase@: {
  570. switch (quirk) {
  571. )~~~");
  572. for (auto& quirk : quirks.values()) {
  573. VERIFY(quirk.is_string());
  574. auto quirk_generator = property_generator.fork();
  575. quirk_generator.set("quirk:titlecase", title_casify(quirk.as_string()));
  576. quirk_generator.append(R"~~~(
  577. case Quirk::@quirk:titlecase@:
  578. return true;
  579. )~~~");
  580. }
  581. property_generator.append(R"~~~(
  582. default:
  583. return false;
  584. }
  585. }
  586. )~~~");
  587. }
  588. }
  589. });
  590. generator.append(R"~~~(
  591. default:
  592. return false;
  593. }
  594. }
  595. bool property_accepts_type(PropertyID property_id, ValueType value_type)
  596. {
  597. switch (property_id) {
  598. )~~~");
  599. properties.for_each_member([&](auto& name, auto& value) {
  600. VERIFY(value.is_object());
  601. auto& object = value.as_object();
  602. if (auto maybe_valid_types = object.get_array("valid-types"sv); maybe_valid_types.has_value() && !maybe_valid_types->is_empty()) {
  603. auto& valid_types = maybe_valid_types.value();
  604. auto property_generator = generator.fork();
  605. property_generator.set("name:titlecase", title_casify(name));
  606. property_generator.append(R"~~~(
  607. case PropertyID::@name:titlecase@: {
  608. switch (value_type) {
  609. )~~~");
  610. bool did_output_accepted_type = false;
  611. for (auto& type : valid_types.values()) {
  612. VERIFY(type.is_string());
  613. auto type_name = type.as_string().split_view(' ').first();
  614. if (type_name_is_enum(type_name))
  615. continue;
  616. if (type_name == "angle") {
  617. property_generator.appendln(" case ValueType::Angle:");
  618. } else if (type_name == "background-position") {
  619. property_generator.appendln(" case ValueType::BackgroundPosition:");
  620. } else if (type_name == "basic-shape") {
  621. property_generator.appendln(" case ValueType::BasicShape:");
  622. } else if (type_name == "color") {
  623. property_generator.appendln(" case ValueType::Color:");
  624. } else if (type_name == "custom-ident") {
  625. property_generator.appendln(" case ValueType::CustomIdent:");
  626. } else if (type_name == "easing-function") {
  627. property_generator.appendln(" case ValueType::EasingFunction:");
  628. } else if (type_name == "flex") {
  629. property_generator.appendln(" case ValueType::Flex:");
  630. } else if (type_name == "frequency") {
  631. property_generator.appendln(" case ValueType::Frequency:");
  632. } else if (type_name == "image") {
  633. property_generator.appendln(" case ValueType::Image:");
  634. } else if (type_name == "integer") {
  635. property_generator.appendln(" case ValueType::Integer:");
  636. } else if (type_name == "length") {
  637. property_generator.appendln(" case ValueType::Length:");
  638. } else if (type_name == "number") {
  639. property_generator.appendln(" case ValueType::Number:");
  640. } else if (type_name == "paint") {
  641. property_generator.appendln(" case ValueType::Paint:");
  642. } else if (type_name == "percentage") {
  643. property_generator.appendln(" case ValueType::Percentage:");
  644. } else if (type_name == "position") {
  645. property_generator.appendln(" case ValueType::Position:");
  646. } else if (type_name == "ratio") {
  647. property_generator.appendln(" case ValueType::Ratio:");
  648. } else if (type_name == "rect") {
  649. property_generator.appendln(" case ValueType::Rect:");
  650. } else if (type_name == "resolution") {
  651. property_generator.appendln(" case ValueType::Resolution:");
  652. } else if (type_name == "string") {
  653. property_generator.appendln(" case ValueType::String:");
  654. } else if (type_name == "time") {
  655. property_generator.appendln(" case ValueType::Time:");
  656. } else if (type_name == "url") {
  657. property_generator.appendln(" case ValueType::Url:");
  658. } else {
  659. VERIFY_NOT_REACHED();
  660. }
  661. did_output_accepted_type = true;
  662. }
  663. if (did_output_accepted_type)
  664. property_generator.appendln(" return true;");
  665. property_generator.append(R"~~~(
  666. default:
  667. return false;
  668. }
  669. }
  670. )~~~");
  671. }
  672. });
  673. generator.append(R"~~~(
  674. default:
  675. return false;
  676. }
  677. }
  678. bool property_accepts_identifier(PropertyID property_id, ValueID identifier)
  679. {
  680. switch (property_id) {
  681. )~~~");
  682. properties.for_each_member([&](auto& name, auto& value) {
  683. VERIFY(value.is_object());
  684. auto& object = value.as_object();
  685. auto property_generator = generator.fork();
  686. property_generator.set("name:titlecase", title_casify(name));
  687. property_generator.appendln(" case PropertyID::@name:titlecase@: {");
  688. if (auto maybe_valid_identifiers = object.get_array("valid-identifiers"sv); maybe_valid_identifiers.has_value() && !maybe_valid_identifiers->is_empty()) {
  689. property_generator.appendln(" switch (identifier) {");
  690. auto& valid_identifiers = maybe_valid_identifiers.value();
  691. for (auto& identifier : valid_identifiers.values()) {
  692. auto identifier_generator = generator.fork();
  693. identifier_generator.set("identifier:titlecase", title_casify(identifier.as_string()));
  694. identifier_generator.appendln(" case ValueID::@identifier:titlecase@:");
  695. }
  696. property_generator.append(R"~~~(
  697. return true;
  698. default:
  699. break;
  700. }
  701. )~~~");
  702. }
  703. if (auto maybe_valid_types = object.get_array("valid-types"sv); maybe_valid_types.has_value() && !maybe_valid_types->is_empty()) {
  704. auto& valid_types = maybe_valid_types.value();
  705. for (auto& valid_type : valid_types.values()) {
  706. auto type_name = valid_type.as_string().split_view(' ').first();
  707. if (!type_name_is_enum(type_name))
  708. continue;
  709. auto type_generator = generator.fork();
  710. type_generator.set("type_name:snakecase", snake_casify(type_name));
  711. type_generator.append(R"~~~(
  712. if (value_id_to_@type_name:snakecase@(identifier).has_value())
  713. return true;
  714. )~~~");
  715. }
  716. }
  717. property_generator.append(R"~~~(
  718. return false;
  719. }
  720. )~~~");
  721. });
  722. generator.append(R"~~~(
  723. default:
  724. return false;
  725. }
  726. }
  727. Optional<ValueType> property_resolves_percentages_relative_to(PropertyID property_id)
  728. {
  729. switch (property_id) {
  730. )~~~");
  731. properties.for_each_member([&](auto& name, auto& value) {
  732. VERIFY(value.is_object());
  733. if (auto resolved_type = value.as_object().get_byte_string("percentages-resolve-to"sv); resolved_type.has_value()) {
  734. auto property_generator = generator.fork();
  735. property_generator.set("name:titlecase", title_casify(name));
  736. property_generator.set("resolved_type:titlecase", title_casify(resolved_type.value()));
  737. property_generator.append(R"~~~(
  738. case PropertyID::@name:titlecase@:
  739. return ValueType::@resolved_type:titlecase@;
  740. )~~~");
  741. }
  742. });
  743. generator.append(R"~~~(
  744. default:
  745. return {};
  746. }
  747. }
  748. size_t property_maximum_value_count(PropertyID property_id)
  749. {
  750. switch (property_id) {
  751. )~~~");
  752. properties.for_each_member([&](auto& name, auto& value) {
  753. VERIFY(value.is_object());
  754. if (value.as_object().has("max-values"sv)) {
  755. JsonValue max_values = value.as_object().get("max-values"sv).release_value();
  756. VERIFY(max_values.is_integer<size_t>());
  757. auto property_generator = generator.fork();
  758. property_generator.set("name:titlecase", title_casify(name));
  759. property_generator.set("max_values", MUST(String::formatted("{}", max_values.as_integer<size_t>())));
  760. property_generator.append(R"~~~(
  761. case PropertyID::@name:titlecase@:
  762. return @max_values@;
  763. )~~~");
  764. }
  765. });
  766. generator.append(R"~~~(
  767. default:
  768. return 1;
  769. }
  770. })~~~");
  771. generate_bounds_checking_function(properties, generator, "angle"sv, "Angle"sv, "Deg"sv);
  772. generate_bounds_checking_function(properties, generator, "flex"sv, "Flex"sv, "Fr"sv);
  773. generate_bounds_checking_function(properties, generator, "frequency"sv, "Frequency"sv, "Hertz"sv);
  774. generate_bounds_checking_function(properties, generator, "integer"sv, "i64"sv, {}, "value"sv);
  775. generate_bounds_checking_function(properties, generator, "length"sv, "Length"sv, {}, "value.raw_value()"sv);
  776. generate_bounds_checking_function(properties, generator, "number"sv, "double"sv, {}, "value"sv);
  777. generate_bounds_checking_function(properties, generator, "percentage"sv, "Percentage"sv, {}, "value.value()"sv);
  778. generate_bounds_checking_function(properties, generator, "resolution"sv, "Resolution"sv, "Dpi"sv);
  779. generate_bounds_checking_function(properties, generator, "time"sv, "Time"sv, "S"sv);
  780. generator.append(R"~~~(
  781. bool property_is_shorthand(PropertyID property_id)
  782. {
  783. switch (property_id) {
  784. )~~~");
  785. properties.for_each_member([&](auto& name, auto& value) {
  786. if (value.as_object().has("longhands"sv)) {
  787. auto property_generator = generator.fork();
  788. property_generator.set("name:titlecase", title_casify(name));
  789. property_generator.append(R"~~~(
  790. case PropertyID::@name:titlecase@:
  791. )~~~");
  792. }
  793. });
  794. generator.append(R"~~~(
  795. return true;
  796. default:
  797. return false;
  798. }
  799. }
  800. )~~~");
  801. generator.append(R"~~~(
  802. Vector<PropertyID> longhands_for_shorthand(PropertyID property_id)
  803. {
  804. switch (property_id) {
  805. )~~~");
  806. properties.for_each_member([&](auto& name, auto& value) {
  807. if (value.as_object().has("longhands"sv)) {
  808. auto longhands = value.as_object().get("longhands"sv);
  809. VERIFY(longhands.has_value() && longhands->is_array());
  810. auto longhand_values = longhands->as_array();
  811. auto property_generator = generator.fork();
  812. property_generator.set("name:titlecase", title_casify(name));
  813. StringBuilder builder;
  814. bool first = true;
  815. longhand_values.for_each([&](auto& longhand) {
  816. if (first)
  817. first = false;
  818. else
  819. builder.append(", "sv);
  820. builder.appendff("PropertyID::{}", title_casify(longhand.as_string()));
  821. return IterationDecision::Continue;
  822. });
  823. property_generator.set("longhands", builder.to_byte_string());
  824. property_generator.append(R"~~~(
  825. case PropertyID::@name:titlecase@:
  826. return { @longhands@ };
  827. )~~~");
  828. }
  829. });
  830. generator.append(R"~~~(
  831. default:
  832. return { };
  833. }
  834. }
  835. )~~~");
  836. generator.append(R"~~~(
  837. } // namespace Web::CSS
  838. )~~~");
  839. TRY(file.write_until_depleted(generator.as_string_view().bytes()));
  840. return {};
  841. }
  842. bool is_animatable_property(JsonObject& properties, StringView property_name)
  843. {
  844. auto property = properties.get_object(property_name);
  845. VERIFY(property.has_value());
  846. if (auto animation_type = property.value().get_byte_string("animation-type"sv); animation_type.has_value()) {
  847. return animation_type != "none";
  848. }
  849. if (!property.value().has("longhands"sv)) {
  850. dbgln("Property '{}' must specify either 'animation-type' or 'longhands'"sv, property_name);
  851. VERIFY_NOT_REACHED();
  852. }
  853. auto longhands = property.value().get_array("longhands"sv);
  854. VERIFY(longhands.has_value());
  855. for (auto const& subproperty_name : longhands->values()) {
  856. VERIFY(subproperty_name.is_string());
  857. if (is_animatable_property(properties, subproperty_name.as_string()))
  858. return true;
  859. }
  860. return false;
  861. }