lutaml 0.11.7 → 0.11.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (881) hide show
  1. checksums.yaml +4 -4
  2. data/.rubocop.yml +20 -0
  3. data/.rubocop_todo.yml +0 -1
  4. data/Gemfile +32 -5
  5. data/README.adoc +3 -3
  6. data/README.md +6 -8
  7. data/Rakefile +41 -1
  8. data/bin/console +0 -1
  9. data/exe/lutaml-lml +6 -0
  10. data/exe/lutaml-lml-lsp +11 -0
  11. data/lib/compat/opal/generate_boot.rb +132 -0
  12. data/lib/compat/opal/js_bundle_entry.rb +42 -0
  13. data/lib/compat/opal/lutaml_model_boot.rb +540 -0
  14. data/lib/compat/opal/monitor.rb +31 -0
  15. data/lib/compat/opal/moxml/adapter/customized_rexml/entity_reference.rb +9 -0
  16. data/lib/compat/opal/moxml/adapter/customized_rexml/formatter.rb +225 -0
  17. data/lib/compat/opal/moxml/adapter/customized_rexml.rb +11 -0
  18. data/lib/compat/opal/moxml_boot.rb +68 -0
  19. data/lib/compat/opal/objectspace_shim.rb +23 -0
  20. data/lib/compat/opal/rexml/namespace.rb +59 -0
  21. data/lib/compat/opal/rexml/parsers/baseparser.rb +1016 -0
  22. data/lib/compat/opal/rexml/source.rb +214 -0
  23. data/lib/compat/opal/rexml/text.rb +426 -0
  24. data/lib/compat/opal/rexml/xmltokens.rb +45 -0
  25. data/lib/compat/opal/rexml_compat.rb +85 -0
  26. data/lib/compat/opal/yaml_compat.rb +32 -0
  27. data/lib/lutaml/hash_format/adapter/document.rb +10 -0
  28. data/lib/lutaml/hash_format/adapter/mapping.rb +17 -0
  29. data/lib/lutaml/hash_format/adapter/mapping_rule.rb +9 -0
  30. data/lib/lutaml/hash_format/adapter/standard_adapter.rb +17 -0
  31. data/lib/lutaml/hash_format/adapter/transform.rb +9 -0
  32. data/lib/lutaml/hash_format/adapter.rb +13 -0
  33. data/lib/lutaml/hash_format/format.rb +29 -0
  34. data/lib/lutaml/hash_format/type/serializers.rb +24 -0
  35. data/lib/lutaml/hash_format.rb +7 -0
  36. data/lib/lutaml/json/adapter/document.rb +13 -0
  37. data/lib/lutaml/json/adapter/mapping.rb +17 -0
  38. data/lib/lutaml/json/adapter/mapping_rule.rb +9 -0
  39. data/lib/lutaml/json/adapter/multi_json_adapter.rb +45 -0
  40. data/lib/lutaml/json/adapter/oj_adapter.rb +41 -0
  41. data/lib/lutaml/json/adapter/standard_adapter.rb +43 -0
  42. data/lib/lutaml/json/adapter/transform.rb +9 -0
  43. data/lib/lutaml/json/adapter/yeptris_adapter.rb +74 -0
  44. data/lib/lutaml/json/adapter.rb +21 -0
  45. data/lib/lutaml/json/format.rb +61 -0
  46. data/lib/lutaml/json/generator_options.rb +62 -0
  47. data/lib/lutaml/json/schema/json_schema.rb +62 -0
  48. data/lib/lutaml/json/schema.rb +9 -0
  49. data/lib/lutaml/json/type/serializers.rb +72 -0
  50. data/lib/lutaml/json.rb +7 -0
  51. data/lib/lutaml/jsonl/adapter/document.rb +14 -0
  52. data/lib/lutaml/jsonl/adapter/mapping.rb +17 -0
  53. data/lib/lutaml/jsonl/adapter/mapping_rule.rb +9 -0
  54. data/lib/lutaml/jsonl/adapter/standard_adapter.rb +34 -0
  55. data/lib/lutaml/jsonl/adapter/transform.rb +26 -0
  56. data/lib/lutaml/jsonl/adapter.rb +13 -0
  57. data/lib/lutaml/jsonl/format.rb +22 -0
  58. data/lib/lutaml/jsonl.rb +7 -0
  59. data/lib/lutaml/jsonld/adapter.rb +31 -0
  60. data/lib/lutaml/jsonld.rb +20 -0
  61. data/lib/lutaml/key_value/adapter/hash/document.rb +13 -0
  62. data/lib/lutaml/key_value/adapter/hash/mapping.rb +17 -0
  63. data/lib/lutaml/key_value/adapter/hash/mapping_rule.rb +9 -0
  64. data/lib/lutaml/key_value/adapter/hash/standard_adapter.rb +19 -0
  65. data/lib/lutaml/key_value/adapter/hash/transform.rb +10 -0
  66. data/lib/lutaml/key_value/adapter/hash.rb +15 -0
  67. data/lib/lutaml/key_value/adapter/json/document.rb +16 -0
  68. data/lib/lutaml/key_value/adapter/json/mapping.rb +22 -0
  69. data/lib/lutaml/key_value/adapter/json/mapping_rule.rb +14 -0
  70. data/lib/lutaml/key_value/adapter/json/multi_json_adapter.rb +54 -0
  71. data/lib/lutaml/key_value/adapter/json/oj_adapter.rb +46 -0
  72. data/lib/lutaml/key_value/adapter/json/standard_adapter.rb +47 -0
  73. data/lib/lutaml/key_value/adapter/json/transform.rb +14 -0
  74. data/lib/lutaml/key_value/adapter/json/yeptris_adapter.rb +15 -0
  75. data/lib/lutaml/key_value/adapter/json.rb +24 -0
  76. data/lib/lutaml/key_value/adapter/jsonl/document.rb +16 -0
  77. data/lib/lutaml/key_value/adapter/jsonl/mapping.rb +17 -0
  78. data/lib/lutaml/key_value/adapter/jsonl/mapping_rule.rb +9 -0
  79. data/lib/lutaml/key_value/adapter/jsonl/standard_adapter.rb +36 -0
  80. data/lib/lutaml/key_value/adapter/jsonl/transform.rb +26 -0
  81. data/lib/lutaml/key_value/adapter/jsonl.rb +17 -0
  82. data/lib/lutaml/key_value/adapter/toml/document.rb +13 -0
  83. data/lib/lutaml/key_value/adapter/toml/mapping.rb +26 -0
  84. data/lib/lutaml/key_value/adapter/toml/mapping_rule.rb +9 -0
  85. data/lib/lutaml/key_value/adapter/toml/teptris_adapter.rb +36 -0
  86. data/lib/lutaml/key_value/adapter/toml/toml_rb_adapter.rb +34 -0
  87. data/lib/lutaml/key_value/adapter/toml/tomlib_adapter.rb +40 -0
  88. data/lib/lutaml/key_value/adapter/toml/transform.rb +10 -0
  89. data/lib/lutaml/key_value/adapter/toml.rb +22 -0
  90. data/lib/lutaml/key_value/adapter/yaml/document.rb +12 -0
  91. data/lib/lutaml/key_value/adapter/yaml/mapping.rb +17 -0
  92. data/lib/lutaml/key_value/adapter/yaml/mapping_rule.rb +9 -0
  93. data/lib/lutaml/key_value/adapter/yaml/standard_adapter.rb +35 -0
  94. data/lib/lutaml/key_value/adapter/yaml/transform.rb +10 -0
  95. data/lib/lutaml/key_value/adapter/yaml/yeptris_adapter.rb +15 -0
  96. data/lib/lutaml/key_value/adapter/yaml.rb +17 -0
  97. data/lib/lutaml/key_value/adapter/yamls/document.rb +16 -0
  98. data/lib/lutaml/key_value/adapter/yamls/mapping.rb +17 -0
  99. data/lib/lutaml/key_value/adapter/yamls/mapping_rule.rb +9 -0
  100. data/lib/lutaml/key_value/adapter/yamls/standard_adapter.rb +37 -0
  101. data/lib/lutaml/key_value/adapter/yamls/transform.rb +26 -0
  102. data/lib/lutaml/key_value/adapter/yamls.rb +17 -0
  103. data/lib/lutaml/key_value/adapter.rb +14 -0
  104. data/lib/lutaml/key_value/data_model/element.rb +225 -0
  105. data/lib/lutaml/key_value/data_model.rb +14 -0
  106. data/lib/lutaml/key_value/document.rb +28 -0
  107. data/lib/lutaml/key_value/format.rb +26 -0
  108. data/lib/lutaml/key_value/mapping.rb +393 -0
  109. data/lib/lutaml/key_value/mapping_rule.rb +95 -0
  110. data/lib/lutaml/key_value/transform.rb +1223 -0
  111. data/lib/lutaml/key_value/transformation/collection_serializer.rb +572 -0
  112. data/lib/lutaml/key_value/transformation/rule_compiler.rb +299 -0
  113. data/lib/lutaml/key_value/transformation/value_serializer.rb +399 -0
  114. data/lib/lutaml/key_value/transformation.rb +1276 -0
  115. data/lib/lutaml/key_value/transformation_builder.rb +30 -0
  116. data/lib/lutaml/key_value.rb +7 -0
  117. data/lib/lutaml/lml/association_label_resolver.rb +52 -0
  118. data/lib/lutaml/lml/cli.rb +506 -0
  119. data/lib/lutaml/lml/data_processor/attribute_processing.rb +133 -0
  120. data/lib/lutaml/lml/data_processor/collection_processing.rb +37 -0
  121. data/lib/lutaml/lml/data_processor/instance_processing.rb +77 -0
  122. data/lib/lutaml/lml/data_processor/value_declaration_processing.rb +70 -0
  123. data/lib/lutaml/lml/data_processor/value_processing.rb +103 -0
  124. data/lib/lutaml/lml/data_processor/view_processing.rb +26 -0
  125. data/lib/lutaml/lml/data_processor.rb +59 -0
  126. data/lib/lutaml/lml/diagnostic.rb +149 -0
  127. data/lib/lutaml/lml/document_builder.rb +481 -0
  128. data/lib/lutaml/lml/entity_types.rb +30 -0
  129. data/lib/lutaml/lml/executor/adapter_helpers.rb +45 -0
  130. data/lib/lutaml/lml/executor/condition_evaluator.rb +169 -0
  131. data/lib/lutaml/lml/executor/csv_adapter.rb +88 -0
  132. data/lib/lutaml/lml/executor/format_adapter.rb +54 -0
  133. data/lib/lutaml/lml/executor/xml_adapter.rb +102 -0
  134. data/lib/lutaml/lml/executor.rb +96 -0
  135. data/lib/lutaml/lml/format/adapter/document.rb +11 -0
  136. data/lib/lutaml/lml/format/adapter/mapping.rb +31 -0
  137. data/lib/lutaml/lml/format/adapter/standard_adapter.rb +162 -0
  138. data/lib/lutaml/lml/format/adapter/transform.rb +11 -0
  139. data/lib/lutaml/lml/format.rb +29 -0
  140. data/lib/lutaml/lml/formatter/base.rb +79 -0
  141. data/lib/lutaml/lml/formatter/canonical.rb +736 -0
  142. data/lib/lutaml/lml/formatter/elk.rb +45 -0
  143. data/lib/lutaml/lml/formatter/svg_pdf/path_parser.rb +134 -0
  144. data/lib/lutaml/lml/formatter/svg_pdf.rb +285 -0
  145. data/lib/lutaml/lml/formatter.rb +11 -0
  146. data/lib/lutaml/lml/grammar/lml.artifact.json +14993 -0
  147. data/lib/lutaml/lml/grammar/lml.parg +389 -0
  148. data/lib/lutaml/lml/grammar.rb +60 -0
  149. data/lib/lutaml/lml/has_attributes.rb +14 -0
  150. data/lib/lutaml/lml/import_resolver.rb +96 -0
  151. data/lib/lutaml/lml/layout/elk_engine.rb +15 -0
  152. data/lib/lutaml/lml/layout/elk_graph_builder.rb +129 -0
  153. data/lib/lutaml/lml/layout/elk_svg_markers.rb +45 -0
  154. data/lib/lutaml/lml/layout/elk_svg_renderer.rb +119 -0
  155. data/lib/lutaml/lml/layout/engine.rb +17 -0
  156. data/lib/lutaml/lml/layout.rb +12 -0
  157. data/lib/lutaml/lml/literal_value.rb +32 -0
  158. data/lib/lutaml/lml/lsp/conversions.rb +78 -0
  159. data/lib/lutaml/lml/lsp/keywords.rb +43 -0
  160. data/lib/lutaml/lml/lsp/server.rb +378 -0
  161. data/lib/lutaml/lml/lsp/store.rb +68 -0
  162. data/lib/lutaml/lml/lsp/transport.rb +53 -0
  163. data/lib/lutaml/lml/lsp.rb +16 -0
  164. data/lib/lutaml/lml/model_compiler/enums.rb +172 -0
  165. data/lib/lutaml/lml/model_compiler/hydration.rb +123 -0
  166. data/lib/lutaml/lml/model_compiler/serialization_mappings.rb +188 -0
  167. data/lib/lutaml/lml/model_compiler/string_formats.rb +42 -0
  168. data/lib/lutaml/lml/model_compiler/validation.rb +65 -0
  169. data/lib/lutaml/lml/model_compiler.rb +323 -0
  170. data/lib/lutaml/lml/models/action.rb +10 -0
  171. data/lib/lutaml/lml/models/association.rb +29 -0
  172. data/lib/lutaml/lml/models/cardinality.rb +10 -0
  173. data/lib/lutaml/lml/models/collection.rb +11 -0
  174. data/lib/lutaml/lml/models/constraint.rb +23 -0
  175. data/lib/lutaml/lml/models/data_type.rb +41 -0
  176. data/lib/lutaml/lml/models/derived_field.rb +14 -0
  177. data/lib/lutaml/lml/models/diagram.rb +20 -0
  178. data/lib/lutaml/lml/models/document.rb +84 -0
  179. data/lib/lutaml/lml/models/enum.rb +38 -0
  180. data/lib/lutaml/lml/models/fidelity.rb +10 -0
  181. data/lib/lutaml/lml/models/group.rb +11 -0
  182. data/lib/lutaml/lml/models/instance.rb +26 -0
  183. data/lib/lutaml/lml/models/instance_collection.rb +16 -0
  184. data/lib/lutaml/lml/models/instances_export.rb +10 -0
  185. data/lib/lutaml/lml/models/instances_import.rb +11 -0
  186. data/lib/lutaml/lml/models/mapping.rb +15 -0
  187. data/lib/lutaml/lml/models/mapping_rule.rb +16 -0
  188. data/lib/lutaml/lml/models/member_field.rb +14 -0
  189. data/lib/lutaml/lml/models/namespace.rb +16 -0
  190. data/lib/lutaml/lml/models/operation.rb +26 -0
  191. data/lib/lutaml/lml/models/operation_parameter.rb +12 -0
  192. data/lib/lutaml/lml/models/package.rb +26 -0
  193. data/lib/lutaml/lml/models/primitive_type.rb +33 -0
  194. data/lib/lutaml/lml/models/reference.rb +23 -0
  195. data/lib/lutaml/lml/models/serialization_mapping.rb +19 -0
  196. data/lib/lutaml/lml/models/string_format.rb +16 -0
  197. data/lib/lutaml/lml/models/top_element_attribute.rb +116 -0
  198. data/lib/lutaml/lml/models/uml_class.rb +85 -0
  199. data/lib/lutaml/lml/models/value.rb +15 -0
  200. data/lib/lutaml/lml/models/view_filter.rb +11 -0
  201. data/lib/lutaml/lml/models/view_import.rb +11 -0
  202. data/lib/lutaml/lml/parser.rb +19 -0
  203. data/lib/lutaml/lml/pipeline.rb +73 -0
  204. data/lib/lutaml/lml/positioned.rb +13 -0
  205. data/lib/lutaml/lml/preprocessor.rb +130 -0
  206. data/lib/lutaml/lml/quoting.rb +60 -0
  207. data/lib/lutaml/lml/source.rb +49 -0
  208. data/lib/lutaml/lml/source_position.rb +20 -0
  209. data/lib/lutaml/lml/symbol_index.rb +200 -0
  210. data/lib/lutaml/lml/transform.rb +119 -0
  211. data/lib/lutaml/lml/types/text_type.rb +28 -0
  212. data/lib/lutaml/lml/types.rb +10 -0
  213. data/lib/lutaml/lml/validator.rb +458 -0
  214. data/lib/lutaml/lml/version.rb +10 -0
  215. data/lib/lutaml/lml/view_resolution.rb +32 -0
  216. data/lib/lutaml/lml/view_resolver.rb +48 -0
  217. data/lib/lutaml/lml/yaml_parser.rb +17 -0
  218. data/lib/lutaml/lml.rb +130 -0
  219. data/lib/lutaml/model/adapter_resolver.rb +487 -0
  220. data/lib/lutaml/model/adapter_scope.rb +64 -0
  221. data/lib/lutaml/model/attribute.rb +1511 -0
  222. data/lib/lutaml/model/attribute_validator.rb +290 -0
  223. data/lib/lutaml/model/cached_type_resolver/concurrent_map_cache.rb +48 -0
  224. data/lib/lutaml/model/cached_type_resolver/mutex_hash_cache.rb +53 -0
  225. data/lib/lutaml/model/cached_type_resolver.rb +145 -0
  226. data/lib/lutaml/model/choice.rb +343 -0
  227. data/lib/lutaml/model/cli.rb +85 -0
  228. data/lib/lutaml/model/collection.rb +740 -0
  229. data/lib/lutaml/model/collection_handler.rb +157 -0
  230. data/lib/lutaml/model/comparable_model.rb +710 -0
  231. data/lib/lutaml/model/comparable_nil.rb +9 -0
  232. data/lib/lutaml/model/comparison.rb +15 -0
  233. data/lib/lutaml/model/compiled_rule.rb +242 -0
  234. data/lib/lutaml/model/config.rb +169 -0
  235. data/lib/lutaml/model/configuration.rb +138 -0
  236. data/lib/lutaml/model/consolidation/attribute_grouper.rb +44 -0
  237. data/lib/lutaml/model/consolidation/dispatcher.rb +45 -0
  238. data/lib/lutaml/model/consolidation/engine.rb +33 -0
  239. data/lib/lutaml/model/consolidation/pattern_chunker.rb +87 -0
  240. data/lib/lutaml/model/consolidation_map.rb +68 -0
  241. data/lib/lutaml/model/consolidation_rule/dispatch_block.rb +34 -0
  242. data/lib/lutaml/model/consolidation_rule/gather_rule.rb +17 -0
  243. data/lib/lutaml/model/consolidation_rule/pattern_content_rule.rb +15 -0
  244. data/lib/lutaml/model/consolidation_rule/pattern_element_rule.rb +17 -0
  245. data/lib/lutaml/model/consolidation_rule.rb +27 -0
  246. data/lib/lutaml/model/constants.rb +11 -0
  247. data/lib/lutaml/model/context_registry.rb +208 -0
  248. data/lib/lutaml/model/deep_dupable.rb +16 -0
  249. data/lib/lutaml/model/error/choice_lower_bound_error.rb +9 -0
  250. data/lib/lutaml/model/error/choice_upper_bound_error.rb +9 -0
  251. data/lib/lutaml/model/error/collection_count_out_of_range_error.rb +29 -0
  252. data/lib/lutaml/model/error/collection_true_missing_error.rb +16 -0
  253. data/lib/lutaml/model/error/element_count_out_of_range_error.rb +35 -0
  254. data/lib/lutaml/model/error/format_adapter_not_specified_error.rb +25 -0
  255. data/lib/lutaml/model/error/fraction_digits_error.rb +20 -0
  256. data/lib/lutaml/model/error/import_model_with_root_error.rb +9 -0
  257. data/lib/lutaml/model/error/incorrect_mapping_argument_error.rb +6 -0
  258. data/lib/lutaml/model/error/incorrect_sequence_error.rb +9 -0
  259. data/lib/lutaml/model/error/invalid_attribute_name_error.rb +15 -0
  260. data/lib/lutaml/model/error/invalid_attribute_options_error.rb +16 -0
  261. data/lib/lutaml/model/error/invalid_attribute_type_error.rb +98 -0
  262. data/lib/lutaml/model/error/invalid_choice_range_error.rb +18 -0
  263. data/lib/lutaml/model/error/invalid_format_error.rb +11 -0
  264. data/lib/lutaml/model/error/invalid_value_error.rb +18 -0
  265. data/lib/lutaml/model/error/length_error.rb +19 -0
  266. data/lib/lutaml/model/error/liquid_class_not_found_error.rb +9 -0
  267. data/lib/lutaml/model/error/liquid_drop_already_registered_error.rb +11 -0
  268. data/lib/lutaml/model/error/liquid_not_enabled_error.rb +9 -0
  269. data/lib/lutaml/model/error/mapping_already_exists_error.rb +6 -0
  270. data/lib/lutaml/model/error/mapping_attribute_missing_error.rb +6 -0
  271. data/lib/lutaml/model/error/mapping_attribute_type_error.rb +6 -0
  272. data/lib/lutaml/model/error/max_exclusive_error.rb +19 -0
  273. data/lib/lutaml/model/error/max_inclusive_error.rb +20 -0
  274. data/lib/lutaml/model/error/max_length_error.rb +20 -0
  275. data/lib/lutaml/model/error/min_exclusive_error.rb +19 -0
  276. data/lib/lutaml/model/error/min_inclusive_error.rb +20 -0
  277. data/lib/lutaml/model/error/min_length_error.rb +20 -0
  278. data/lib/lutaml/model/error/mixed_content_collection_error.rb +17 -0
  279. data/lib/lutaml/model/error/multiple_mappings_error.rb +6 -0
  280. data/lib/lutaml/model/error/no_attributes_defined_liquid_error.rb +9 -0
  281. data/lib/lutaml/model/error/no_mapping_found_error.rb +9 -0
  282. data/lib/lutaml/model/error/no_root_mapping_error.rb +10 -0
  283. data/lib/lutaml/model/error/no_root_namespace_error.rb +10 -0
  284. data/lib/lutaml/model/error/ordered_content_mapping_error.rb +17 -0
  285. data/lib/lutaml/model/error/pattern_not_matched_error.rb +17 -0
  286. data/lib/lutaml/model/error/polymorphic_error.rb +14 -0
  287. data/lib/lutaml/model/error/register/not_registrable_class_error.rb +11 -0
  288. data/lib/lutaml/model/error/required_attribute_missing_error.rb +9 -0
  289. data/lib/lutaml/model/error/restriction_error.rb +8 -0
  290. data/lib/lutaml/model/error/reverse_transform_block_not_defined_error.rb +6 -0
  291. data/lib/lutaml/model/error/reverse_transformation_declaration_error.rb +6 -0
  292. data/lib/lutaml/model/error/sorting_configuration_conflict_error.rb +9 -0
  293. data/lib/lutaml/model/error/total_digits_error.rb +20 -0
  294. data/lib/lutaml/model/error/transform_block_not_defined_error.rb +6 -0
  295. data/lib/lutaml/model/error/type/invalid_value_error.rb +21 -0
  296. data/lib/lutaml/model/error/type/max_bound_error.rb +20 -0
  297. data/lib/lutaml/model/error/type/max_exclusive_error.rb +20 -0
  298. data/lib/lutaml/model/error/type/max_length_error.rb +20 -0
  299. data/lib/lutaml/model/error/type/min_bound_error.rb +20 -0
  300. data/lib/lutaml/model/error/type/min_exclusive_error.rb +20 -0
  301. data/lib/lutaml/model/error/type/min_length_error.rb +20 -0
  302. data/lib/lutaml/model/error/type/pattern_not_matched_error.rb +18 -0
  303. data/lib/lutaml/model/error/type.rb +19 -0
  304. data/lib/lutaml/model/error/type_error.rb +9 -0
  305. data/lib/lutaml/model/error/type_not_enabled_error.rb +9 -0
  306. data/lib/lutaml/model/error/type_only_mapping_error.rb +13 -0
  307. data/lib/lutaml/model/error/type_only_namespace_error.rb +12 -0
  308. data/lib/lutaml/model/error/undefined_attribute_error.rb +9 -0
  309. data/lib/lutaml/model/error/union_schema_unsupported_error.rb +11 -0
  310. data/lib/lutaml/model/error/unknown_adapter_type_error.rb +95 -0
  311. data/lib/lutaml/model/error/unknown_discriminator_error.rb +11 -0
  312. data/lib/lutaml/model/error/unknown_mapping_error.rb +18 -0
  313. data/lib/lutaml/model/error/unknown_sequence_mapping_error.rb +9 -0
  314. data/lib/lutaml/model/error/unknown_type_error.rb +32 -0
  315. data/lib/lutaml/model/error/unresolvable_type_error.rb +27 -0
  316. data/lib/lutaml/model/error/unsupported_version_error.rb +14 -0
  317. data/lib/lutaml/model/error/validation_error.rb +20 -0
  318. data/lib/lutaml/model/error/validation_failed_error.rb +9 -0
  319. data/lib/lutaml/model/error.rb +8 -0
  320. data/lib/lutaml/model/errors.rb +38 -0
  321. data/lib/lutaml/model/evolution_steps.rb +85 -0
  322. data/lib/lutaml/model/finalization_cache.rb +51 -0
  323. data/lib/lutaml/model/format_registry.rb +218 -0
  324. data/lib/lutaml/model/global_context.rb +476 -0
  325. data/lib/lutaml/model/global_register.rb +142 -0
  326. data/lib/lutaml/model/hash.rb +15 -0
  327. data/lib/lutaml/model/import_registry.rb +250 -0
  328. data/lib/lutaml/model/instrumentation.rb +304 -0
  329. data/lib/lutaml/model/json.rb +25 -0
  330. data/lib/lutaml/model/json_adapter.rb +8 -0
  331. data/lib/lutaml/model/jsonl.rb +15 -0
  332. data/lib/lutaml/model/liquefiable.rb +198 -0
  333. data/lib/lutaml/model/liquid/indexed_access.rb +33 -0
  334. data/lib/lutaml/model/liquid/mapping.rb +30 -0
  335. data/lib/lutaml/model/liquid.rb +10 -0
  336. data/lib/lutaml/model/lml/document.rb +109 -0
  337. data/lib/lutaml/model/lml/exporter.rb +328 -0
  338. data/lib/lutaml/model/lml/rejected_error.rb +32 -0
  339. data/lib/lutaml/model/lml/round_trip.rb +49 -0
  340. data/lib/lutaml/model/lml.rb +40 -0
  341. data/lib/lutaml/model/mapping/listener.rb +126 -0
  342. data/lib/lutaml/model/mapping/mapping.rb +209 -0
  343. data/lib/lutaml/model/mapping/mapping_rule.rb +673 -0
  344. data/lib/lutaml/model/mapping/model_mapping.rb +133 -0
  345. data/lib/lutaml/model/mapping/model_mapping_rule.rb +57 -0
  346. data/lib/lutaml/model/mapping_hash.rb +80 -0
  347. data/lib/lutaml/model/model_transformer.rb +101 -0
  348. data/lib/lutaml/model/one_entry_cache.rb +57 -0
  349. data/lib/lutaml/model/organization.rb +29 -0
  350. data/lib/lutaml/model/register/model_tree_importer.rb +88 -0
  351. data/lib/lutaml/model/register/namespace_binding.rb +92 -0
  352. data/lib/lutaml/model/register.rb +589 -0
  353. data/lib/lutaml/model/registrable.rb +8 -0
  354. data/lib/lutaml/model/render_policy.rb +166 -0
  355. data/lib/lutaml/model/restriction_validation.rb +437 -0
  356. data/lib/lutaml/model/runtime_compatibility.rb +144 -0
  357. data/lib/lutaml/model/schema/base_schema.rb +77 -0
  358. data/lib/lutaml/model/schema/class_loader.rb +59 -0
  359. data/lib/lutaml/model/schema/compiled_output.rb +83 -0
  360. data/lib/lutaml/model/schema/decorators/attribute.rb +116 -0
  361. data/lib/lutaml/model/schema/decorators/choices.rb +29 -0
  362. data/lib/lutaml/model/schema/decorators/class_definition.rb +84 -0
  363. data/lib/lutaml/model/schema/decorators/definition_collection.rb +97 -0
  364. data/lib/lutaml/model/schema/decorators.rb +15 -0
  365. data/lib/lutaml/model/schema/definitions/attribute.rb +32 -0
  366. data/lib/lutaml/model/schema/definitions/choice.rb +20 -0
  367. data/lib/lutaml/model/schema/definitions/facet.rb +40 -0
  368. data/lib/lutaml/model/schema/definitions/group_import.rb +22 -0
  369. data/lib/lutaml/model/schema/definitions/member_walk.rb +33 -0
  370. data/lib/lutaml/model/schema/definitions/model.rb +40 -0
  371. data/lib/lutaml/model/schema/definitions/namespace.rb +24 -0
  372. data/lib/lutaml/model/schema/definitions/restricted_type.rb +32 -0
  373. data/lib/lutaml/model/schema/definitions/sequence.rb +19 -0
  374. data/lib/lutaml/model/schema/definitions/simple_content.rb +22 -0
  375. data/lib/lutaml/model/schema/definitions/transform_facet.rb +21 -0
  376. data/lib/lutaml/model/schema/definitions/type_ref.rb +20 -0
  377. data/lib/lutaml/model/schema/definitions/union_type.rb +28 -0
  378. data/lib/lutaml/model/schema/definitions/xml_root.rb +20 -0
  379. data/lib/lutaml/model/schema/definitions.rb +24 -0
  380. data/lib/lutaml/model/schema/file_writer.rb +73 -0
  381. data/lib/lutaml/model/schema/generator/definition.rb +98 -0
  382. data/lib/lutaml/model/schema/generator/definitions_collection.rb +117 -0
  383. data/lib/lutaml/model/schema/generator/properties_collection.rb +65 -0
  384. data/lib/lutaml/model/schema/generator/property.rb +182 -0
  385. data/lib/lutaml/model/schema/generator/ref.rb +24 -0
  386. data/lib/lutaml/model/schema/generator.rb +15 -0
  387. data/lib/lutaml/model/schema/helpers/template_helper.rb +49 -0
  388. data/lib/lutaml/model/schema/helpers.rb +11 -0
  389. data/lib/lutaml/model/schema/json_schema.rb +17 -0
  390. data/lib/lutaml/model/schema/json_schema_parser.rb +91 -0
  391. data/lib/lutaml/model/schema/module_nesting.rb +31 -0
  392. data/lib/lutaml/model/schema/namespace_naming.rb +46 -0
  393. data/lib/lutaml/model/schema/registry_generator.rb +115 -0
  394. data/lib/lutaml/model/schema/renderer.rb +38 -0
  395. data/lib/lutaml/model/schema/renderers/base.rb +41 -0
  396. data/lib/lutaml/model/schema/renderers/mappings.rb +78 -0
  397. data/lib/lutaml/model/schema/renderers/member_decls.rb +121 -0
  398. data/lib/lutaml/model/schema/renderers/model.rb +133 -0
  399. data/lib/lutaml/model/schema/renderers/namespace.rb +30 -0
  400. data/lib/lutaml/model/schema/renderers/registration.rb +64 -0
  401. data/lib/lutaml/model/schema/renderers/required_files_calculator.rb +94 -0
  402. data/lib/lutaml/model/schema/renderers/restricted_type.rb +218 -0
  403. data/lib/lutaml/model/schema/renderers/union.rb +83 -0
  404. data/lib/lutaml/model/schema/renderers.rb +20 -0
  405. data/lib/lutaml/model/schema/rnc_compiler/source_resolver.rb +51 -0
  406. data/lib/lutaml/model/schema/rnc_compiler.rb +64 -0
  407. data/lib/lutaml/model/schema/rng_compiler/define_classifier.rb +94 -0
  408. data/lib/lutaml/model/schema/rng_compiler/element_visitor.rb +412 -0
  409. data/lib/lutaml/model/schema/rng_compiler/member_collector.rb +30 -0
  410. data/lib/lutaml/model/schema/rng_compiler/rng_helpers.rb +160 -0
  411. data/lib/lutaml/model/schema/rng_compiler/value_type_resolver.rb +129 -0
  412. data/lib/lutaml/model/schema/rng_compiler.rb +225 -0
  413. data/lib/lutaml/model/schema/schema_builder/nokogiri.rb +41 -0
  414. data/lib/lutaml/model/schema/schema_builder/oga.rb +92 -0
  415. data/lib/lutaml/model/schema/shared_methods.rb +24 -0
  416. data/lib/lutaml/model/schema/templates/model.erb +9 -0
  417. data/lib/lutaml/model/schema/templates.rb +164 -0
  418. data/lib/lutaml/model/schema/xml_compiler/element_order.rb +42 -0
  419. data/lib/lutaml/model/schema/xml_compiler/registry_generator.rb +51 -0
  420. data/lib/lutaml/model/schema/xml_compiler/spec_builder/complex_types.rb +198 -0
  421. data/lib/lutaml/model/schema/xml_compiler/spec_builder/members.rb +249 -0
  422. data/lib/lutaml/model/schema/xml_compiler/spec_builder/simple_types.rb +185 -0
  423. data/lib/lutaml/model/schema/xml_compiler/spec_builder.rb +186 -0
  424. data/lib/lutaml/model/schema/xml_compiler/supported_data_types.rb +100 -0
  425. data/lib/lutaml/model/schema/xml_compiler.rb +109 -0
  426. data/lib/lutaml/model/schema/yaml_schema.rb +17 -0
  427. data/lib/lutaml/model/schema.rb +88 -0
  428. data/lib/lutaml/model/schema_location.rb +18 -0
  429. data/lib/lutaml/model/sequence.rb +220 -0
  430. data/lib/lutaml/model/serializable.rb +46 -0
  431. data/lib/lutaml/model/serialization_adapter.rb +24 -0
  432. data/lib/lutaml/model/serialize/attribute_definition.rb +897 -0
  433. data/lib/lutaml/model/serialize/builder.rb +258 -0
  434. data/lib/lutaml/model/serialize/conversion_caching.rb +129 -0
  435. data/lib/lutaml/model/serialize/deserialization_context.rb +51 -0
  436. data/lib/lutaml/model/serialize/enum_handling.rb +171 -0
  437. data/lib/lutaml/model/serialize/format_conversion.rb +624 -0
  438. data/lib/lutaml/model/serialize/initialization.rb +825 -0
  439. data/lib/lutaml/model/serialize/model_import.rb +425 -0
  440. data/lib/lutaml/model/serialize/transformation_builder.rb +128 -0
  441. data/lib/lutaml/model/serialize/value_mapping.rb +173 -0
  442. data/lib/lutaml/model/serialize.rb +533 -0
  443. data/lib/lutaml/model/services/base.rb +13 -0
  444. data/lib/lutaml/model/services/logger.rb +57 -0
  445. data/lib/lutaml/model/services/rule_value_extractor.rb +95 -0
  446. data/lib/lutaml/model/services/transformer.rb +143 -0
  447. data/lib/lutaml/model/services/type/validator/number.rb +25 -0
  448. data/lib/lutaml/model/services/type/validator/string.rb +53 -0
  449. data/lib/lutaml/model/services/type/validator/symbol.rb +30 -0
  450. data/lib/lutaml/model/services/type/validator.rb +69 -0
  451. data/lib/lutaml/model/services/type.rb +9 -0
  452. data/lib/lutaml/model/services/validator.rb +143 -0
  453. data/lib/lutaml/model/services.rb +10 -0
  454. data/lib/lutaml/model/store.rb +239 -0
  455. data/lib/lutaml/model/toml.rb +40 -0
  456. data/lib/lutaml/model/transform/xml_transform.rb +5 -0
  457. data/lib/lutaml/model/transform.rb +229 -0
  458. data/lib/lutaml/model/transformation.rb +89 -0
  459. data/lib/lutaml/model/transformation_builder.rb +55 -0
  460. data/lib/lutaml/model/transformation_registry.rb +327 -0
  461. data/lib/lutaml/model/type/base64_binary.rb +58 -0
  462. data/lib/lutaml/model/type/boolean.rb +35 -0
  463. data/lib/lutaml/model/type/date.rb +75 -0
  464. data/lib/lutaml/model/type/date_time.rb +60 -0
  465. data/lib/lutaml/model/type/date_time_with_timezone.rb +28 -0
  466. data/lib/lutaml/model/type/date_with_timezone.rb +28 -0
  467. data/lib/lutaml/model/type/day_time_duration.rb +35 -0
  468. data/lib/lutaml/model/type/decimal.rb +64 -0
  469. data/lib/lutaml/model/type/duration.rb +82 -0
  470. data/lib/lutaml/model/type/email_address.rb +28 -0
  471. data/lib/lutaml/model/type/float.rb +33 -0
  472. data/lib/lutaml/model/type/hash.rb +74 -0
  473. data/lib/lutaml/model/type/hex_binary.rb +56 -0
  474. data/lib/lutaml/model/type/hostname.rb +30 -0
  475. data/lib/lutaml/model/type/integer.rb +62 -0
  476. data/lib/lutaml/model/type/ip_v4_address.rb +27 -0
  477. data/lib/lutaml/model/type/ip_v6_address.rb +47 -0
  478. data/lib/lutaml/model/type/metaschema_pattern.rb +34 -0
  479. data/lib/lutaml/model/type/non_negative_integer.rb +25 -0
  480. data/lib/lutaml/model/type/positive_integer.rb +25 -0
  481. data/lib/lutaml/model/type/qname.rb +85 -0
  482. data/lib/lutaml/model/type/reference.rb +76 -0
  483. data/lib/lutaml/model/type/string.rb +62 -0
  484. data/lib/lutaml/model/type/symbol.rb +67 -0
  485. data/lib/lutaml/model/type/time.rb +52 -0
  486. data/lib/lutaml/model/type/time_without_date.rb +50 -0
  487. data/lib/lutaml/model/type/token.rb +25 -0
  488. data/lib/lutaml/model/type/uninitialized_class_guard.rb +36 -0
  489. data/lib/lutaml/model/type/uri.rb +51 -0
  490. data/lib/lutaml/model/type/uri_reference.rb +29 -0
  491. data/lib/lutaml/model/type/uuid.rb +25 -0
  492. data/lib/lutaml/model/type/value.rb +364 -0
  493. data/lib/lutaml/model/type/year_month_duration.rb +29 -0
  494. data/lib/lutaml/model/type.rb +199 -0
  495. data/lib/lutaml/model/type_context.rb +294 -0
  496. data/lib/lutaml/model/type_registry.rb +165 -0
  497. data/lib/lutaml/model/type_resolver.rb +187 -0
  498. data/lib/lutaml/model/type_substitution.rb +117 -0
  499. data/lib/lutaml/model/uninitialized_class.rb +70 -0
  500. data/lib/lutaml/model/union.rb +363 -0
  501. data/lib/lutaml/model/utils.rb +352 -0
  502. data/lib/lutaml/model/validation/concerns/has_issues.rb +27 -0
  503. data/lib/lutaml/model/validation/context.rb +36 -0
  504. data/lib/lutaml/model/validation/issue.rb +62 -0
  505. data/lib/lutaml/model/validation/layer_result.rb +34 -0
  506. data/lib/lutaml/model/validation/profile.rb +66 -0
  507. data/lib/lutaml/model/validation/registry.rb +60 -0
  508. data/lib/lutaml/model/validation/remediation.rb +33 -0
  509. data/lib/lutaml/model/validation/remediation_result.rb +20 -0
  510. data/lib/lutaml/model/validation/report.rb +39 -0
  511. data/lib/lutaml/model/validation/rule.rb +59 -0
  512. data/lib/lutaml/model/validation.rb +137 -0
  513. data/lib/lutaml/model/validation_framework.rb +77 -0
  514. data/lib/lutaml/model/value_policy.rb +27 -0
  515. data/lib/lutaml/model/value_transformer.rb +25 -0
  516. data/lib/lutaml/model/version.rb +7 -0
  517. data/lib/lutaml/model/yaml.rb +15 -0
  518. data/lib/lutaml/model/yamls.rb +15 -0
  519. data/lib/lutaml/model.rb +309 -0
  520. data/lib/lutaml/rdf/context.rb +69 -0
  521. data/lib/lutaml/rdf/error.rb +7 -0
  522. data/lib/lutaml/rdf/iri.rb +44 -0
  523. data/lib/lutaml/rdf/language_tagged.rb +11 -0
  524. data/lib/lutaml/rdf/linked_data_transform.rb +249 -0
  525. data/lib/lutaml/rdf/literal.rb +62 -0
  526. data/lib/lutaml/rdf/mapping.rb +86 -0
  527. data/lib/lutaml/rdf/mapping_rule.rb +52 -0
  528. data/lib/lutaml/rdf/member_rule.rb +55 -0
  529. data/lib/lutaml/rdf/namespace.rb +58 -0
  530. data/lib/lutaml/rdf/namespace_set.rb +69 -0
  531. data/lib/lutaml/rdf/namespaces/dcterms_namespace.rb +12 -0
  532. data/lib/lutaml/rdf/namespaces/owl_namespace.rb +12 -0
  533. data/lib/lutaml/rdf/namespaces/rdf_namespace.rb +14 -0
  534. data/lib/lutaml/rdf/namespaces/rdfs_namespace.rb +12 -0
  535. data/lib/lutaml/rdf/namespaces/skos_namespace.rb +12 -0
  536. data/lib/lutaml/rdf/namespaces/xsd_namespace.rb +12 -0
  537. data/lib/lutaml/rdf/namespaces.rb +14 -0
  538. data/lib/lutaml/rdf/term_definition.rb +39 -0
  539. data/lib/lutaml/rdf/transform.rb +45 -0
  540. data/lib/lutaml/rdf.rb +22 -0
  541. data/lib/lutaml/toml/adapter/document.rb +10 -0
  542. data/lib/lutaml/toml/adapter/mapping.rb +26 -0
  543. data/lib/lutaml/toml/adapter/mapping_rule.rb +9 -0
  544. data/lib/lutaml/toml/adapter/teptris_adapter.rb +14 -0
  545. data/lib/lutaml/toml/adapter/toml_rb_adapter.rb +32 -0
  546. data/lib/lutaml/toml/adapter/tomlib_adapter.rb +48 -0
  547. data/lib/lutaml/toml/adapter/transform.rb +9 -0
  548. data/lib/lutaml/toml/adapter.rb +20 -0
  549. data/lib/lutaml/toml/format.rb +48 -0
  550. data/lib/lutaml/toml/type/serializers.rb +71 -0
  551. data/lib/lutaml/toml.rb +7 -0
  552. data/lib/lutaml/turtle/adapter.rb +35 -0
  553. data/lib/lutaml/turtle/mapping.rb +7 -0
  554. data/lib/lutaml/turtle/transform.rb +250 -0
  555. data/lib/lutaml/turtle.rb +22 -0
  556. data/lib/lutaml/version.rb +1 -1
  557. data/lib/lutaml/xml/adapter/adapter_helpers.rb +108 -0
  558. data/lib/lutaml/xml/adapter/base_adapter.rb +249 -0
  559. data/lib/lutaml/xml/adapter/leptris_adapter.rb +16 -0
  560. data/lib/lutaml/xml/adapter/namespace_data.rb +56 -0
  561. data/lib/lutaml/xml/adapter/namespace_uri_collector.rb +71 -0
  562. data/lib/lutaml/xml/adapter/nokogiri_adapter.rb +16 -0
  563. data/lib/lutaml/xml/adapter/oga_adapter.rb +20 -0
  564. data/lib/lutaml/xml/adapter/ox_adapter.rb +16 -0
  565. data/lib/lutaml/xml/adapter/plan_based_builder.rb +944 -0
  566. data/lib/lutaml/xml/adapter/rexml_adapter.rb +25 -0
  567. data/lib/lutaml/xml/adapter/xml_parser.rb +89 -0
  568. data/lib/lutaml/xml/adapter/xml_serializer.rb +334 -0
  569. data/lib/lutaml/xml/adapter.rb +24 -0
  570. data/lib/lutaml/xml/adapter_element.rb +339 -0
  571. data/lib/lutaml/xml/adapter_loader.rb +56 -0
  572. data/lib/lutaml/xml/attribute_namespace_resolver.rb +139 -0
  573. data/lib/lutaml/xml/blank_namespace.rb +51 -0
  574. data/lib/lutaml/xml/blank_namespace_handler.rb +50 -0
  575. data/lib/lutaml/xml/builder/base.rb +258 -0
  576. data/lib/lutaml/xml/builder/leptris.rb +13 -0
  577. data/lib/lutaml/xml/builder/nokogiri.rb +13 -0
  578. data/lib/lutaml/xml/builder/oga.rb +13 -0
  579. data/lib/lutaml/xml/builder/ox.rb +13 -0
  580. data/lib/lutaml/xml/builder/rexml.rb +13 -0
  581. data/lib/lutaml/xml/builder.rb +18 -0
  582. data/lib/lutaml/xml/configurable.rb +215 -0
  583. data/lib/lutaml/xml/data_model.rb +295 -0
  584. data/lib/lutaml/xml/decisions/decision.rb +120 -0
  585. data/lib/lutaml/xml/decisions/decision_context.rb +225 -0
  586. data/lib/lutaml/xml/decisions/decision_engine.rb +67 -0
  587. data/lib/lutaml/xml/decisions/decision_rule.rb +54 -0
  588. data/lib/lutaml/xml/decisions/element_prefix_resolver.rb +85 -0
  589. data/lib/lutaml/xml/decisions/rules/attribute_usage_rule.rb +37 -0
  590. data/lib/lutaml/xml/decisions/rules/default_preference_rule.rb +62 -0
  591. data/lib/lutaml/xml/decisions/rules/element_form_default_rule.rb +66 -0
  592. data/lib/lutaml/xml/decisions/rules/element_form_default_unqualified_rule.rb +73 -0
  593. data/lib/lutaml/xml/decisions/rules/element_form_option_rule.rb +83 -0
  594. data/lib/lutaml/xml/decisions/rules/explicit_option_rule.rb +57 -0
  595. data/lib/lutaml/xml/decisions/rules/format_preservation_rule.rb +74 -0
  596. data/lib/lutaml/xml/decisions/rules/hoisted_on_parent_rule.rb +60 -0
  597. data/lib/lutaml/xml/decisions/rules/inherit_from_parent_rule.rb +52 -0
  598. data/lib/lutaml/xml/decisions/rules/inherit_parent_prefix_rule.rb +69 -0
  599. data/lib/lutaml/xml/decisions/rules/namespace_scope_rule.rb +54 -0
  600. data/lib/lutaml/xml/decisions/rules/reuse_parent_prefix_rule.rb +78 -0
  601. data/lib/lutaml/xml/decisions/rules/used_prefix_rule.rb +70 -0
  602. data/lib/lutaml/xml/decisions/rules.rb +39 -0
  603. data/lib/lutaml/xml/decisions.rb +15 -0
  604. data/lib/lutaml/xml/declaration_handler.rb +115 -0
  605. data/lib/lutaml/xml/declaration_plan/attribute_node.rb +81 -0
  606. data/lib/lutaml/xml/declaration_plan/element_node.rb +101 -0
  607. data/lib/lutaml/xml/declaration_plan.rb +480 -0
  608. data/lib/lutaml/xml/declaration_plan_query.rb +105 -0
  609. data/lib/lutaml/xml/declaration_planner.rb +1914 -0
  610. data/lib/lutaml/xml/doctype_extractor.rb +51 -0
  611. data/lib/lutaml/xml/document.rb +385 -0
  612. data/lib/lutaml/xml/element.rb +108 -0
  613. data/lib/lutaml/xml/element_prefix_resolver.rb +50 -0
  614. data/lib/lutaml/xml/encoding_normalizer.rb +54 -0
  615. data/lib/lutaml/xml/error/invalid_namespace_error.rb +46 -0
  616. data/lib/lutaml/xml/error/invalid_xsd_type_error.rb +43 -0
  617. data/lib/lutaml/xml/error/namespace_mismatch_error.rb +53 -0
  618. data/lib/lutaml/xml/error/schema_validation_error.rb +25 -0
  619. data/lib/lutaml/xml/error/xml_configuration_error.rb +17 -0
  620. data/lib/lutaml/xml/error/xml_error.rb +21 -0
  621. data/lib/lutaml/xml/format.rb +364 -0
  622. data/lib/lutaml/xml/format_chooser.rb +214 -0
  623. data/lib/lutaml/xml/hoisting_algorithm.rb +234 -0
  624. data/lib/lutaml/xml/html_entities.rb +290 -0
  625. data/lib/lutaml/xml/leptris/element.rb +34 -0
  626. data/lib/lutaml/xml/leptris/native_emission.rb +295 -0
  627. data/lib/lutaml/xml/leptris/plan_compiler.rb +652 -0
  628. data/lib/lutaml/xml/leptris/plan_hydrator.rb +827 -0
  629. data/lib/lutaml/xml/leptris/plan_order.rb +72 -0
  630. data/lib/lutaml/xml/leptris/plan_serializer.rb +711 -0
  631. data/lib/lutaml/xml/leptris/plan_walk.rb +36 -0
  632. data/lib/lutaml/xml/leptris.rb +48 -0
  633. data/lib/lutaml/xml/listener.rb +33 -0
  634. data/lib/lutaml/xml/mapping.rb +1746 -0
  635. data/lib/lutaml/xml/mapping_rule.rb +688 -0
  636. data/lib/lutaml/xml/model_transform.rb +1824 -0
  637. data/lib/lutaml/xml/namespace.rb +445 -0
  638. data/lib/lutaml/xml/namespace_class_registry.rb +144 -0
  639. data/lib/lutaml/xml/namespace_collector.rb +649 -0
  640. data/lib/lutaml/xml/namespace_declaration.rb +202 -0
  641. data/lib/lutaml/xml/namespace_declaration_builder.rb +67 -0
  642. data/lib/lutaml/xml/namespace_declaration_data.rb +179 -0
  643. data/lib/lutaml/xml/namespace_inheritance_resolver.rb +142 -0
  644. data/lib/lutaml/xml/namespace_inheritance_strategy.rb +26 -0
  645. data/lib/lutaml/xml/namespace_needs.rb +255 -0
  646. data/lib/lutaml/xml/namespace_resolution_strategy.rb +230 -0
  647. data/lib/lutaml/xml/namespace_resolver.rb +219 -0
  648. data/lib/lutaml/xml/namespace_scope_config.rb +110 -0
  649. data/lib/lutaml/xml/namespace_type_resolver.rb +135 -0
  650. data/lib/lutaml/xml/namespace_usage.rb +121 -0
  651. data/lib/lutaml/xml/nested_collection_attribute.rb +95 -0
  652. data/lib/lutaml/xml/nokogiri/element.rb +34 -0
  653. data/lib/lutaml/xml/nokogiri.rb +10 -0
  654. data/lib/lutaml/xml/oga/element.rb +15 -0
  655. data/lib/lutaml/xml/oga.rb +10 -0
  656. data/lib/lutaml/xml/ox/element.rb +15 -0
  657. data/lib/lutaml/xml/ox.rb +10 -0
  658. data/lib/lutaml/xml/parse_session.rb +139 -0
  659. data/lib/lutaml/xml/parsed_namespace_declaration.rb +129 -0
  660. data/lib/lutaml/xml/parsed_namespace_set.rb +149 -0
  661. data/lib/lutaml/xml/polymorphic_value_handler.rb +41 -0
  662. data/lib/lutaml/xml/qualified_inheritance_strategy.rb +27 -0
  663. data/lib/lutaml/xml/rexml/element.rb +15 -0
  664. data/lib/lutaml/xml/rexml.rb +10 -0
  665. data/lib/lutaml/xml/schema/builder/nokogiri.rb +41 -0
  666. data/lib/lutaml/xml/schema/builder/oga.rb +92 -0
  667. data/lib/lutaml/xml/schema/builder.rb +59 -0
  668. data/lib/lutaml/xml/schema/builtin_types.rb +112 -0
  669. data/lib/lutaml/xml/schema/relaxng_schema.rb +83 -0
  670. data/lib/lutaml/xml/schema/xsd/all.rb +31 -0
  671. data/lib/lutaml/xml/schema/xsd/annotation.rb +31 -0
  672. data/lib/lutaml/xml/schema/xsd/any.rb +33 -0
  673. data/lib/lutaml/xml/schema/xsd/any_attribute.rb +29 -0
  674. data/lib/lutaml/xml/schema/xsd/appinfo.rb +25 -0
  675. data/lib/lutaml/xml/schema/xsd/attribute.rb +78 -0
  676. data/lib/lutaml/xml/schema/xsd/attribute_group.rb +89 -0
  677. data/lib/lutaml/xml/schema/xsd/base.rb +270 -0
  678. data/lib/lutaml/xml/schema/xsd/choice.rb +68 -0
  679. data/lib/lutaml/xml/schema/xsd/complex_content.rb +39 -0
  680. data/lib/lutaml/xml/schema/xsd/complex_type.rb +159 -0
  681. data/lib/lutaml/xml/schema/xsd/documentation.rb +26 -0
  682. data/lib/lutaml/xml/schema/xsd/element.rb +117 -0
  683. data/lib/lutaml/xml/schema/xsd/enumeration.rb +25 -0
  684. data/lib/lutaml/xml/schema/xsd/errors/enhanced_error.rb +142 -0
  685. data/lib/lutaml/xml/schema/xsd/errors/error_context.rb +67 -0
  686. data/lib/lutaml/xml/schema/xsd/errors/message_builder.rb +103 -0
  687. data/lib/lutaml/xml/schema/xsd/errors/suggestion.rb +67 -0
  688. data/lib/lutaml/xml/schema/xsd/errors/troubleshooters/namespace_troubleshooter.rb +96 -0
  689. data/lib/lutaml/xml/schema/xsd/errors/troubleshooters/troubleshooting_handler.rb +70 -0
  690. data/lib/lutaml/xml/schema/xsd/errors.rb +148 -0
  691. data/lib/lutaml/xml/schema/xsd/extension_complex_content.rb +63 -0
  692. data/lib/lutaml/xml/schema/xsd/extension_simple_content.rb +48 -0
  693. data/lib/lutaml/xml/schema/xsd/field.rb +25 -0
  694. data/lib/lutaml/xml/schema/xsd/file_validation_result.rb +55 -0
  695. data/lib/lutaml/xml/schema/xsd/fraction_digits.rb +29 -0
  696. data/lib/lutaml/xml/schema/xsd/glob.rb +105 -0
  697. data/lib/lutaml/xml/schema/xsd/group.rb +79 -0
  698. data/lib/lutaml/xml/schema/xsd/import.rb +33 -0
  699. data/lib/lutaml/xml/schema/xsd/include.rb +31 -0
  700. data/lib/lutaml/xml/schema/xsd/key.rb +32 -0
  701. data/lib/lutaml/xml/schema/xsd/keyref.rb +34 -0
  702. data/lib/lutaml/xml/schema/xsd/length.rb +27 -0
  703. data/lib/lutaml/xml/schema/xsd/list.rb +29 -0
  704. data/lib/lutaml/xml/schema/xsd/max_exclusive.rb +25 -0
  705. data/lib/lutaml/xml/schema/xsd/max_inclusive.rb +23 -0
  706. data/lib/lutaml/xml/schema/xsd/max_length.rb +25 -0
  707. data/lib/lutaml/xml/schema/xsd/min_exclusive.rb +25 -0
  708. data/lib/lutaml/xml/schema/xsd/min_inclusive.rb +23 -0
  709. data/lib/lutaml/xml/schema/xsd/min_length.rb +25 -0
  710. data/lib/lutaml/xml/schema/xsd/namespace_mapping.rb +37 -0
  711. data/lib/lutaml/xml/schema/xsd/namespace_uri_remapping.rb +79 -0
  712. data/lib/lutaml/xml/schema/xsd/notation.rb +31 -0
  713. data/lib/lutaml/xml/schema/xsd/pattern.rb +25 -0
  714. data/lib/lutaml/xml/schema/xsd/redefine.rb +35 -0
  715. data/lib/lutaml/xml/schema/xsd/restriction_complex_content.rb +56 -0
  716. data/lib/lutaml/xml/schema/xsd/restriction_simple_content.rb +84 -0
  717. data/lib/lutaml/xml/schema/xsd/restriction_simple_type.rb +64 -0
  718. data/lib/lutaml/xml/schema/xsd/schema.rb +379 -0
  719. data/lib/lutaml/xml/schema/xsd/schema_file_validation_results.rb +55 -0
  720. data/lib/lutaml/xml/schema/xsd/schema_location_mapping.rb +74 -0
  721. data/lib/lutaml/xml/schema/xsd/schema_name_resolver.rb +32 -0
  722. data/lib/lutaml/xml/schema/xsd/schema_path.rb +207 -0
  723. data/lib/lutaml/xml/schema/xsd/schema_validator.rb +259 -0
  724. data/lib/lutaml/xml/schema/xsd/selector.rb +27 -0
  725. data/lib/lutaml/xml/schema/xsd/sequence.rb +68 -0
  726. data/lib/lutaml/xml/schema/xsd/serialized_schema.rb +185 -0
  727. data/lib/lutaml/xml/schema/xsd/simple_content.rb +61 -0
  728. data/lib/lutaml/xml/schema/xsd/simple_type.rb +37 -0
  729. data/lib/lutaml/xml/schema/xsd/total_digits.rb +29 -0
  730. data/lib/lutaml/xml/schema/xsd/type_index_entry.rb +40 -0
  731. data/lib/lutaml/xml/schema/xsd/type_resolution_result.rb +112 -0
  732. data/lib/lutaml/xml/schema/xsd/union.rb +30 -0
  733. data/lib/lutaml/xml/schema/xsd/unique.rb +31 -0
  734. data/lib/lutaml/xml/schema/xsd/validation_error.rb +48 -0
  735. data/lib/lutaml/xml/schema/xsd/validation_result.rb +86 -0
  736. data/lib/lutaml/xml/schema/xsd/version.rb +11 -0
  737. data/lib/lutaml/xml/schema/xsd/white_space.rb +27 -0
  738. data/lib/lutaml/xml/schema/xsd.rb +164 -0
  739. data/lib/lutaml/xml/schema/xsd_namespace.rb +29 -0
  740. data/lib/lutaml/xml/schema/xsd_schema.rb +1002 -0
  741. data/lib/lutaml/xml/schema.rb +16 -0
  742. data/lib/lutaml/xml/schema_location.rb +155 -0
  743. data/lib/lutaml/xml/serialization/collection_ext.rb +61 -0
  744. data/lib/lutaml/xml/serialization/format_conversion.rb +433 -0
  745. data/lib/lutaml/xml/serialization/instance_methods.rb +323 -0
  746. data/lib/lutaml/xml/serialization/model_import_ext.rb +40 -0
  747. data/lib/lutaml/xml/serialization.rb +15 -0
  748. data/lib/lutaml/xml/shared_dsl.rb +119 -0
  749. data/lib/lutaml/xml/transform.rb +6 -0
  750. data/lib/lutaml/xml/transformation/custom_method_wrapper.rb +258 -0
  751. data/lib/lutaml/xml/transformation/element_builder.rb +697 -0
  752. data/lib/lutaml/xml/transformation/order_reconciler.rb +282 -0
  753. data/lib/lutaml/xml/transformation/ordered_applier.rb +529 -0
  754. data/lib/lutaml/xml/transformation/rule_applier.rb +403 -0
  755. data/lib/lutaml/xml/transformation/rule_compiler.rb +556 -0
  756. data/lib/lutaml/xml/transformation/skip_logic.rb +70 -0
  757. data/lib/lutaml/xml/transformation/value_serializer.rb +137 -0
  758. data/lib/lutaml/xml/transformation.rb +454 -0
  759. data/lib/lutaml/xml/transformation_builder.rb +28 -0
  760. data/lib/lutaml/xml/transformation_support.rb +15 -0
  761. data/lib/lutaml/xml/type/configurable.rb +153 -0
  762. data/lib/lutaml/xml/type/serializers.rb +105 -0
  763. data/lib/lutaml/xml/type/value_xml_mapping.rb +94 -0
  764. data/lib/lutaml/xml/type_namespace/collector.rb +101 -0
  765. data/lib/lutaml/xml/type_namespace/declaration.rb +61 -0
  766. data/lib/lutaml/xml/type_namespace/planner.rb +121 -0
  767. data/lib/lutaml/xml/type_namespace/reference.rb +71 -0
  768. data/lib/lutaml/xml/type_namespace/resolver.rb +43 -0
  769. data/lib/lutaml/xml/type_namespace.rb +13 -0
  770. data/lib/lutaml/xml/type_namespace_resolver.rb +76 -0
  771. data/lib/lutaml/xml/unqualified_inheritance_strategy.rb +34 -0
  772. data/lib/lutaml/xml/w3c/registration.rb +66 -0
  773. data/lib/lutaml/xml/w3c.rb +398 -0
  774. data/lib/lutaml/xml/xml_attribute.rb +58 -0
  775. data/lib/lutaml/xml/xml_element.rb +498 -0
  776. data/lib/lutaml/xml/xml_namespace.rb +72 -0
  777. data/lib/lutaml/xml/xml_orderable.rb +17 -0
  778. data/lib/lutaml/xml/xsd_validator.rb +66 -0
  779. data/lib/lutaml/xml.rb +7 -0
  780. data/lib/lutaml/yaml/adapter/document.rb +12 -0
  781. data/lib/lutaml/yaml/adapter/mapping.rb +17 -0
  782. data/lib/lutaml/yaml/adapter/mapping_rule.rb +9 -0
  783. data/lib/lutaml/yaml/adapter/standard_adapter.rb +35 -0
  784. data/lib/lutaml/yaml/adapter/transform.rb +9 -0
  785. data/lib/lutaml/yaml/adapter/yeptris_adapter.rb +107 -0
  786. data/lib/lutaml/yaml/adapter.rb +18 -0
  787. data/lib/lutaml/yaml/format.rb +31 -0
  788. data/lib/lutaml/yaml/schema/yaml_schema.rb +65 -0
  789. data/lib/lutaml/yaml/schema.rb +9 -0
  790. data/lib/lutaml/yaml/type/serializers.rb +60 -0
  791. data/lib/lutaml/yaml.rb +7 -0
  792. data/lib/lutaml/yamlld/adapter.rb +20 -0
  793. data/lib/lutaml/yamlld.rb +25 -0
  794. data/lib/lutaml/yamls/adapter/document.rb +14 -0
  795. data/lib/lutaml/yamls/adapter/mapping.rb +30 -0
  796. data/lib/lutaml/yamls/adapter/mapping_rule.rb +9 -0
  797. data/lib/lutaml/yamls/adapter/standard_adapter.rb +56 -0
  798. data/lib/lutaml/yamls/adapter/transform.rb +124 -0
  799. data/lib/lutaml/yamls/adapter/yamls_sequence.rb +20 -0
  800. data/lib/lutaml/yamls/adapter/yamls_sequence_rule.rb +48 -0
  801. data/lib/lutaml/yamls/adapter.rb +15 -0
  802. data/lib/lutaml/yamls/format.rb +22 -0
  803. data/lib/lutaml/yamls.rb +7 -0
  804. data/lib/lutaml.rb +11 -5
  805. data/lib/tasks/benchmark_runner.rb +161 -0
  806. data/lib/tasks/memory_profile.rb +176 -0
  807. data/lib/tasks/performance.rake +80 -0
  808. data/lib/tasks/performance_benchmark.rb +499 -0
  809. data/lib/tasks/performance_comparator.rb +130 -0
  810. data/lib/tasks/performance_helpers.rb +149 -0
  811. data/lib/tasks/performance_probe.rake +33 -0
  812. data/lib/tasks/performance_probe.rb +106 -0
  813. data/lib/tasks/performance_probe_plan_walk.rb +58 -0
  814. data/lib/tasks/performance_probe_xml.rb +54 -0
  815. data/lib/tasks/xml_compiler_benchmark.rb +226 -0
  816. data/lib/tasks/xml_optimization_benchmark.rb +178 -0
  817. data/lutaml.gemspec +16 -8
  818. metadata +902 -83
  819. data/.github/workflows/docs.yml +0 -86
  820. data/.github/workflows/links.yml +0 -113
  821. data/.github/workflows/rake.yml +0 -23
  822. data/.github/workflows/release.yml +0 -37
  823. data/.gitignore +0 -29
  824. data/CLAUDE.md +0 -62
  825. data/docs/.github/workflows/docs.yml +0 -66
  826. data/docs/.github/workflows/links.yml +0 -78
  827. data/docs/CONTINUATION_PLAN.md +0 -168
  828. data/docs/Gemfile +0 -13
  829. data/docs/MIGRATION_GUIDE.md +0 -202
  830. data/docs/README.md +0 -252
  831. data/docs/REFACTOR_PLAN.md +0 -214
  832. data/docs/_config.yml +0 -144
  833. data/docs/_guides/cli-usage.adoc +0 -43
  834. data/docs/_guides/diagram-generation.adoc +0 -316
  835. data/docs/_guides/index.adoc +0 -136
  836. data/docs/_guides/parsing/express-parsing.adoc +0 -42
  837. data/docs/_guides/parsing/index.adoc +0 -78
  838. data/docs/_guides/parsing/qea-parsing.adoc +0 -47
  839. data/docs/_guides/parsing/xmi-parsing.adoc +0 -40
  840. data/docs/_guides/repository-management.adoc +0 -44
  841. data/docs/_guides/sysml-modeling.adoc +0 -37
  842. data/docs/_guides/uml-modeling.adoc +0 -115
  843. data/docs/_pages/concepts/diagram-generation.adoc +0 -337
  844. data/docs/_pages/concepts/lur-format.adoc +0 -711
  845. data/docs/_pages/concepts/qea-parsing.adoc +0 -418
  846. data/docs/_pages/concepts/uml-models.adoc +0 -43
  847. data/docs/_pages/core/architecture.adoc +0 -329
  848. data/docs/_pages/core/installation.adoc +0 -321
  849. data/docs/_pages/core/overview.adoc +0 -197
  850. data/docs/_pages/index.adoc +0 -49
  851. data/docs/_pages/uml-syntax.adoc +0 -1011
  852. data/docs/_references/api/parsers.adoc +0 -61
  853. data/docs/_references/api/presenters.adoc +0 -43
  854. data/docs/_references/api/repository.adoc +0 -67
  855. data/docs/_references/cli/commands.adoc +0 -72
  856. data/docs/_references/configuration/diagram-styles.adoc +0 -716
  857. data/docs/_references/configuration/index.adoc +0 -53
  858. data/docs/_references/configuration/package-metadata.adoc +0 -416
  859. data/docs/_references/formats/index.adoc +0 -43
  860. data/docs/_references/formats/lur-format.adoc +0 -39
  861. data/docs/_references/formats/lutaml-syntax.adoc +0 -379
  862. data/docs/_references/formats/qea-structure.adoc +0 -1364
  863. data/docs/_references/index.adoc +0 -198
  864. data/docs/_tutorials/documentation-site.adoc +0 -47
  865. data/docs/_tutorials/first-lur-package.adoc +0 -45
  866. data/docs/_tutorials/generating-diagrams.adoc +0 -42
  867. data/docs/_tutorials/getting-started.adoc +0 -45
  868. data/docs/_tutorials/index.adoc +0 -100
  869. data/docs/_tutorials/querying-models.adoc +0 -44
  870. data/docs/examples/build_package.rb +0 -12
  871. data/docs/examples/build_site.rb +0 -12
  872. data/docs/examples/city_model.rb +0 -21
  873. data/docs/examples/present_class.rb +0 -10
  874. data/docs/examples/query_model.rb +0 -12
  875. data/docs/examples/render_diagram.rb +0 -11
  876. data/docs/index.adoc +0 -64
  877. data/docs/lychee.toml +0 -50
  878. data/lib/lutaml/express/parsers/exp.rb +0 -28
  879. data/lib/lutaml/express.rb +0 -10
  880. data/scripts/check-site-urls.rb +0 -54
  881. data/scripts/check-vendor-link.py +0 -64
@@ -0,0 +1,897 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Lutaml
4
+ module Model
5
+ module Serialize
6
+ # Handles attribute definition methods for Serialize::ClassMethods
7
+ #
8
+ # Extracted from serialize.rb to improve code organization.
9
+ # Provides methods for defining and validating model attributes.
10
+ module AttributeDefinition
11
+ # Whether the per-class accessors and the state-defaults seed are
12
+ # compiled from Ruby source with a String class_eval (the fast
13
+ # path). Opal has no runtime compiler unless opal-parser is
14
+ # bundled, so there every such method is defined from a block
15
+ # with define_method instead.
16
+ # Core dispatch for the block-form methods, bound per call so an
17
+ # attribute or method a model defines with one of these names
18
+ # (send, __send__, instance_variable_get, const_get, ...) is never invoked;
19
+ # the compiled form reads ivars and calls methods directly.
20
+ IVAR_GET = ::Kernel.instance_method(:instance_variable_get)
21
+ IVAR_SET = ::Kernel.instance_method(:instance_variable_set)
22
+ SEND = ::BasicObject.instance_method(:__send__)
23
+ CONST_GET = ::Module.instance_method(:const_get)
24
+
25
+ def self.source_compilation?
26
+ !Lutaml::Model.opal?
27
+ end
28
+
29
+ # Define attribute methods on the model class
30
+ #
31
+ # @param attr [Attribute] The attribute to define methods for
32
+ # @param register [Symbol, nil] The register for type resolution
33
+ # Compile (per class, cached) the method that seeds every attribute
34
+ # with its "no data arrived" sentinel: collections share the frozen
35
+ # LAZY_EMPTY_COLLECTION, scalars share the UninitializedClass
36
+ # singleton. Compiled once instead of walked per instance — the
37
+ # grammars-compile-don't-interpret rule applied to object state.
38
+ # Compile (per class and register, on demand) the method that
39
+ # seeds every attribute with its "no data arrived" sentinel:
40
+ # collections share the frozen LAZY_EMPTY_COLLECTION, scalars
41
+ # share the UninitializedClass singleton. Compiled once instead
42
+ # of walked per instance — grammars compile, they don't
43
+ # interpret.
44
+ def compiled_state_defaults_name!(register_id)
45
+ @state_defaults_names ||= {}
46
+ name = @state_defaults_names[register_id]
47
+ return name if name
48
+
49
+ method_name = :"__init_state_defaults_#{register_id}"
50
+ compile_state_defaults!(method_name, register_id)
51
+ @state_defaults_names[register_id] = method_name
52
+ method_name
53
+ end
54
+
55
+ def compile_state_defaults!(method_name, register_id = nil)
56
+ attrs = attributes(register_id)
57
+
58
+ if attrs.empty?
59
+ define_method(method_name) do
60
+ # no attributes to seed
61
+ end
62
+ return
63
+ end
64
+
65
+ unless AttributeDefinition.source_compilation?
66
+ seeds = attrs.map do |name, attr|
67
+ sentinel = if attr.collection?
68
+ Lutaml::Model::Serialize::LAZY_EMPTY_COLLECTION
69
+ else
70
+ Lutaml::Model::UninitializedClass.instance
71
+ end
72
+ [:"@#{name}", sentinel]
73
+ end
74
+ # Raw readers for every attribute the register sees, as the
75
+ # compiled form below does (#933).
76
+ attrs.each_key { |name| define_raw_state_reader(name) }
77
+ define_method(method_name) do
78
+ # Returns the last seeded value, as the compiled form's final
79
+ # assignment does.
80
+ seeds.reduce(nil) { |_, (ivar, sentinel)| IVAR_SET.bind_call(self, ivar, sentinel) }
81
+ end
82
+ return
83
+ end
84
+
85
+ lines = attrs.map do |name, attr|
86
+ if attr.collection?
87
+ "@#{name} = Lutaml::Model::Serialize::LAZY_EMPTY_COLLECTION"
88
+ else
89
+ "@#{name} = Lutaml::Model::UninitializedClass.instance"
90
+ end
91
+ end.join("\n")
92
+
93
+ # class_eval interpolates per-attribute `@name = <sentinel>` lines:
94
+ # def __init_state_defaults_default
95
+ # @id = Lutaml::Model::UninitializedClass.instance
96
+ # @items = Lutaml::Model::Serialize::LAZY_EMPTY_COLLECTION
97
+ # end
98
+ class_eval(<<~RUBY, __FILE__, __LINE__ + 1) # rubocop:disable Style/DocumentDynamicEvalDefinition
99
+ def #{method_name}
100
+ #{lines}
101
+ end
102
+ RUBY
103
+
104
+ # Raw readers compiled alongside the seeding so every
105
+ # attribute the register can see — including late-merged
106
+ # imports that bypass define_attribute_methods — carries
107
+ # one (#933). Idempotent with the declaration-time
108
+ # definition.
109
+ raw_lines = attrs.filter_map do |name, _attr|
110
+ next unless name.to_s.match?(PLAIN_NAME)
111
+
112
+ <<~RUBY
113
+ def __lutaml_raw_#{name}
114
+ @#{name}
115
+ end
116
+ RUBY
117
+ end.join
118
+ class_eval(<<~RUBY, __FILE__, __LINE__ + 1) # rubocop:disable Style/DocumentDynamicEvalDefinition
119
+ #{raw_lines}
120
+ RUBY
121
+ end
122
+
123
+ # The walk-side seed (#1003): constructor-equivalent state in one
124
+ # compiled pass. Unlike the deserialization seed (sentinels, lazy
125
+ # collections — readers answer uninitialized), the programmatic
126
+ # constructor resolves defaults and leaves non-defaulted
127
+ # attributes nil with explicit using-default marks; the KV walk's
128
+ # absent-attribute rendering contract depends on exactly that.
129
+ def walk_state_defaults_name!(register_id)
130
+ @walk_state_defaults_names ||= {}
131
+ name = @walk_state_defaults_names[register_id]
132
+ return name if name
133
+
134
+ method_name = :"__init_walk_state_defaults_#{register_id}"
135
+ compile_walk_state_defaults!(method_name, register_id)
136
+ @walk_state_defaults_names[register_id] = method_name
137
+ method_name
138
+ end
139
+
140
+ def compile_walk_state_defaults!(method_name, register_id = nil)
141
+ attrs = attributes(register_id)
142
+ marks = {}
143
+ simple = []
144
+ complex = []
145
+ lazy = []
146
+ attrs.each do |name, attr|
147
+ next if attr.derived?
148
+
149
+ # Inline only the provably-simple shape: no default, no
150
+ # value set (enum attributes materialize through their
151
+ # writer), plain ivar-safe name. The constructor's end
152
+ # state for that shape is exactly `nil` + a false mark.
153
+ # Everything else — defaults, enums, delegated and exotic
154
+ # attributes — routes through the constructor's own
155
+ # per-attribute code, so its state is identical by
156
+ # construction.
157
+ marks[name] = false
158
+ plain_name = name.to_s.match?(PLAIN_NAME)
159
+ if plain_name && attr.lazy_collection_default?
160
+ # The implicit empty-collection default: the constructor
161
+ # ends at `[]` + a default mark, and the LAZY sentinel
162
+ # answers `[]` from the reader — so seed the sentinel and
163
+ # skip the per-instance lambda (#1010). The false mark is
164
+ # what the XML unmatched-rule contract reads: a seeded
165
+ # collection must not render as a mid-parse default.
166
+ lazy << name
167
+ elsif attr.default_kind == :none && attr.options[:values].nil? &&
168
+ plain_name
169
+ simple << name
170
+ else
171
+ complex << name
172
+ end
173
+ end
174
+
175
+ marks_line = if marks.empty?
176
+ "@using_default = {}"
177
+ else
178
+ pairs = marks.map { |k, v| "#{k.inspect} => #{v}" }
179
+ "@using_default = { #{pairs.join(', ')} }"
180
+ end
181
+ simple_lines = simple.map { |n| "@#{n} = nil" }
182
+ lazy_lines = lazy.map do |n|
183
+ "@#{n} = Lutaml::Model::Serialize::LAZY_EMPTY_COLLECTION"
184
+ end
185
+ complex_lines = complex.map do |n|
186
+ "initialize_single_attribute({}, #{n.inspect}, " \
187
+ "self.class.attributes(@lutaml_register)[#{n.inspect}], " \
188
+ "Serialize::DEFAULT_VALUE_MAP)"
189
+ end
190
+
191
+ unless AttributeDefinition.source_compilation?
192
+ define_method(method_name) do
193
+ @using_default = marks
194
+ simple.each { |n| IVAR_SET.bind_call(self, :"@#{n}", nil) }
195
+ lazy.each do |n|
196
+ IVAR_SET.bind_call(
197
+ self, :"@#{n}", Lutaml::Model::Serialize::LAZY_EMPTY_COLLECTION
198
+ )
199
+ end
200
+ complex.each do |n|
201
+ initialize_single_attribute(
202
+ {}, n, self.class.attributes(@lutaml_register)[n],
203
+ Serialize::DEFAULT_VALUE_MAP
204
+ )
205
+ end
206
+ end
207
+ return
208
+ end
209
+
210
+ class_eval(<<~RUBY, __FILE__, __LINE__ + 1) # rubocop:disable Style/DocumentDynamicEvalDefinition
211
+ def #{method_name}
212
+ #{marks_line}
213
+ #{simple_lines.join("\n")}
214
+ #{lazy_lines.join("\n")}
215
+ #{complex_lines.join("\n")}
216
+ end
217
+ RUBY
218
+ end
219
+
220
+ # Block-form raw-state reader (no String eval), defined on self.
221
+ def define_raw_state_reader(name)
222
+ ivar = :"@#{name}"
223
+ define_method(:"__lutaml_raw_#{name}") do
224
+ IVAR_GET.bind_call(self, ivar)
225
+ end
226
+ end
227
+
228
+ # Historical getter shape for punctuation-named attributes and
229
+ # any name the compiled form cannot express.
230
+ def define_reflective_attribute_methods(name, attr)
231
+ if attr.collection?
232
+ define_method(name) do |*args|
233
+ if args.empty?
234
+ materialize_lazy_collection(name)
235
+ else
236
+ # Builder-style: g.member(item) appends to collection
237
+ value = args.first
238
+ current = instance_variable_get(:"@#{name}") || []
239
+ new_value = current.is_a?(Array) ? current + [value] : value
240
+ instance_variable_set(:"@#{name}", new_value)
241
+ record_mutation(name, value)
242
+ value
243
+ end
244
+ end
245
+ else
246
+ define_method(name) do |*args|
247
+ if args.empty?
248
+ instance_variable_get(:"@#{name}")
249
+ else
250
+ public_send(:"#{name}=", args.first)
251
+ args.first
252
+ end
253
+ end
254
+ end
255
+ end
256
+
257
+ def invalidate_state_defaults!
258
+ # Opal's method_defined? takes no inherit flag (see the
259
+ # setter_defined check in define_regular_attribute_methods).
260
+ (@state_defaults_names ||= {}).each_key do |compiled|
261
+ defined_now = if Lutaml::Model.opal?
262
+ method_defined?(compiled)
263
+ else
264
+ method_defined?(compiled, false)
265
+ end
266
+ remove_method(compiled) if defined_now
267
+ end
268
+ # The names cache must go with the methods: the memoized
269
+ # lookup answers stale names for removed methods otherwise.
270
+ @state_defaults_names.clear
271
+ end
272
+
273
+ def define_attribute_methods(attr, register = nil)
274
+ name = attr.name
275
+ register_id = extract_register_id(register)
276
+
277
+ # lutaml-model#922: raw-state reader for the deserializer's
278
+ # unmatched-rule handling. A custom writer that assigns a
279
+ # *different* attribute mid-parse (relaton's ICS Isoics
280
+ # fallback; any derived-value pattern) is invisible to the
281
+ # value_set tracker -- public setters don't mark it -- so the
282
+ # tracked "still default" state lies. The deserializer needs
283
+ # the raw stored state to know whether an attribute was
284
+ # writer-populated: still holding the initialized marker
285
+ # (sentinel / lazy collection) means unset; anything else was
286
+ # written since init and must never be overwritten by an
287
+ # unmatched rule's default assignment. Declared here (not in
288
+ # the state-defaults compilation) so late declarations get it
289
+ # too -- XMI's extension loader declares attributes after
290
+ # first parse.
291
+ # Without a source compiler, compile_state_defaults! defines
292
+ # its raw readers from blocks; define one for every name here
293
+ # too (define_method takes any name, not only plain ones).
294
+ # Both forms define on self: a bare `model` receiver resolves
295
+ # through the host class's own namespace (omml's Base answers
296
+ # a Store model) and defined the reader on the wrong object
297
+ # (#933).
298
+ if !AttributeDefinition.source_compilation?
299
+ define_raw_state_reader(name)
300
+ elsif name.to_s.match?(PLAIN_NAME)
301
+ class_eval(<<~RUBY, __FILE__, __LINE__ + 1) # rubocop:disable Style/DocumentDynamicEvalDefinition
302
+ def __lutaml_raw_#{name}
303
+ @#{name}
304
+ end
305
+ RUBY
306
+ end
307
+
308
+ if attr.enum?
309
+ add_enum_methods_to_model(
310
+ model,
311
+ name,
312
+ attr.options[:values],
313
+ collection: attr.options[:collection],
314
+ )
315
+ elsif attr.derived? && name != attr.method_name
316
+ unless method_defined?(name, false)
317
+ define_method(name) do
318
+ value = public_send(attr.method_name)
319
+ # Cast the derived value to the specified type. cast_derived,
320
+ # not cast_element: this reader is its own casting entry point,
321
+ # so it needs the same "nothing arrived, nothing to cast" rule
322
+ # the writers get, and a collection has to come back as one.
323
+ attr.cast_derived(value, register_id)
324
+ end
325
+ end
326
+ elsif attr.unresolved_type == Lutaml::Model::Type::Reference
327
+ Lutaml::Model::Store.reference_types_in_use!
328
+ define_reference_methods(name, register_id)
329
+ else
330
+ define_regular_attribute_methods(name, attr)
331
+ end
332
+ end
333
+
334
+ # Define reference-type attribute methods
335
+ #
336
+ # Reference types store a reference key that can be resolved to
337
+ # the actual object.
338
+ #
339
+ # @param name [Symbol] The attribute name
340
+ # @param register [Symbol] The register ID
341
+ def define_reference_methods(name, register)
342
+ register_id = register
343
+ attr = attributes[name]
344
+
345
+ unless method_defined?(:"#{name}_ref", false)
346
+ define_method("#{name}_ref") do
347
+ instance_variable_get(:"@#{name}_ref")
348
+ end
349
+ end
350
+
351
+ key_method_name = if attr.options[:collection]
352
+ Utils.pluralize(attr.options[:ref_key_attribute].to_s)
353
+ else
354
+ attr.options[:ref_key_attribute]
355
+ end
356
+
357
+ unless method_defined?(:"#{name}_#{key_method_name}", false)
358
+ define_method("#{name}_#{key_method_name}") do
359
+ ref = instance_variable_get(:"@#{name}_ref")
360
+ # attr.reference_key first: once a collection reader has stored
361
+ # its resolved objects, the key has to come back off the object.
362
+ resolve_reference_key(attr.reference_key(ref))
363
+ end
364
+ end
365
+
366
+ unless method_defined?(name, false)
367
+ if attr.options[:collection]
368
+ define_method(name) do
369
+ materialize_reference_collection(name)
370
+ end
371
+ else
372
+ define_method(name) do
373
+ ref = instance_variable_get(:"@#{name}_ref")
374
+ resolve_reference_value(ref)
375
+ end
376
+ end
377
+ end
378
+
379
+ unless method_defined?(:"#{name}=", false)
380
+ define_method(:"#{name}=") do |value|
381
+ value_set_for(name)
382
+ casted_value = value
383
+ unless casted_value.is_a?(Lutaml::Model::Type::Reference)
384
+ casted_value = attr.cast_value(value, register_id)
385
+ end
386
+
387
+ instance_variable_set(:"@#{name}_ref", casted_value)
388
+
389
+ resolved_reference = resolve_reference_key(casted_value)
390
+ instance_variable_set(:"@#{name}", resolved_reference)
391
+ end
392
+ end
393
+ end
394
+
395
+ # Define regular (non-reference, non-enum) attribute methods
396
+ #
397
+ # @param name [Symbol] The attribute name
398
+ # @param attr [Attribute] The attribute definition
399
+ # Plain identifier names compile to `@name` reads; punctuation
400
+ # names (`mixed?`) keep the reflective path (@name is not valid
401
+ # Ruby for them).
402
+ PLAIN_NAME = /\A[a-zA-Z_][a-zA-Z0-9_]*\z/
403
+
404
+ def define_regular_attribute_methods(name, attr)
405
+ unless name.to_s.match?(PLAIN_NAME)
406
+ return define_reflective_attribute_methods(name, attr)
407
+ end
408
+
409
+ # Getters compile with a sentinel default argument instead of a
410
+ # `*args` splat: the splat allocated an (almost always empty)
411
+ # Array on EVERY read — the largest per-call allocation source
412
+ # on instance-heavy parses (TODO.max-perf/06). The optional-arg
413
+ # form allocates nothing, and the read is a direct @ivar.
414
+ if !AttributeDefinition.source_compilation?
415
+ define_block_attribute_getter(name, attr)
416
+ elsif attr.collection?
417
+ # class_eval interpolates, e.g.:
418
+ # def items(arg = Lutaml::Model::Serialize::NO_ARG)
419
+ # if arg.equal?(Lutaml::Model::Serialize::NO_ARG)
420
+ # materialize_lazy_collection(:items)
421
+ # else
422
+ # ... builder append ...
423
+ # end
424
+ # end
425
+ class_eval(<<~RUBY, __FILE__, __LINE__ + 1) # rubocop:disable Style/DocumentDynamicEvalDefinition
426
+ def #{name}(arg = Lutaml::Model::Serialize::NO_ARG)
427
+ if arg.equal?(Lutaml::Model::Serialize::NO_ARG)
428
+ materialize_lazy_collection(:#{name})
429
+ else
430
+ current = @#{name} || []
431
+ new_value = current.is_a?(Array) ? current + [arg] : arg
432
+ @#{name} = new_value
433
+ record_mutation(:#{name}, arg)
434
+ arg
435
+ end
436
+ end
437
+ RUBY
438
+ else
439
+ class_eval(<<~RUBY, __FILE__, __LINE__ + 1) # rubocop:disable Style/DocumentDynamicEvalDefinition
440
+ def #{name}(arg = Lutaml::Model::Serialize::NO_ARG)
441
+ if arg.equal?(Lutaml::Model::Serialize::NO_ARG)
442
+ @#{name}
443
+ else
444
+ public_send(:"#{name}=", arg)
445
+ arg
446
+ end
447
+ end
448
+ RUBY
449
+ end
450
+
451
+ enum_shorthand_names = instance_variable_get(:@__enum_shorthand_names__) || Set.new
452
+ # Opal's Module#method_defined? only accepts 1 arg (MRI accepts
453
+ # the optional `inherit` flag). Skip the flag there — the
454
+ # difference only matters for inherited-method filtering.
455
+ setter_defined = if Lutaml::Model.opal?
456
+ method_defined?(:"#{name}=")
457
+ else
458
+ method_defined?(:"#{name}=", false)
459
+ end
460
+ return if setter_defined && !enum_shorthand_names.include?(name.to_s)
461
+
462
+ # class_eval'd bodies cannot close over locals; a hidden
463
+ # define_method accessor holds the Attribute handle.
464
+ attr_reader_method = :"__attribute_definition_#{name}"
465
+ reader_defined = if Lutaml::Model.opal?
466
+ method_defined?(attr_reader_method)
467
+ else
468
+ method_defined?(attr_reader_method, false)
469
+ end
470
+ define_method(attr_reader_method) { attr } unless reader_defined
471
+
472
+ if !AttributeDefinition.source_compilation?
473
+ define_block_attribute_setters(name, attr)
474
+ elsif attr.collection? && !attr.lazy_collection_default?
475
+ # class_eval interpolates, e.g.:
476
+ # def items=(value)
477
+ # value_set_for(:items)
478
+ # value = ATTR.cast_value(value, lutaml_register)
479
+ # current = @items
480
+ # ... sentinel preservation ...
481
+ # record_mutation_collection(:items, value)
482
+ # end
483
+ # The compiled body writes @items directly: the define_method
484
+ # form interpolated "@items" name strings per call — one per
485
+ # setter invocation on instance-heavy parses (TODO.max-perf/06).
486
+ class_eval(<<~RUBY, __FILE__, __LINE__ + 1) # rubocop:disable Style/DocumentDynamicEvalDefinition
487
+ def #{name}=(value)
488
+ value_set_for(:#{name})
489
+ value = __attribute_definition_#{name}.cast_value(value, lutaml_register)
490
+ current = @#{name}
491
+ if current.equal?(Lutaml::Model::Serialize::LAZY_EMPTY_COLLECTION) &&
492
+ (value.nil? || Lutaml::Model::Utils.uninitialized?(value))
493
+ # Sentinel stays — no allocation for truly empty collections
494
+ else
495
+ @#{name} = value
496
+ end
497
+ record_mutation_collection(:#{name}, value)
498
+ end
499
+
500
+ # TODO.max-perf/31: the deserialization transforms already
501
+ # cast through the format-aware path; this writer skips the
502
+ # setter's re-cast while keeping value_set_for marking and
503
+ # mutation recording. Public assignment keeps the caster.
504
+ def __assign_parsed_#{name}=(value)
505
+ value_set_for(:#{name})
506
+ current = @#{name}
507
+ if current.equal?(Lutaml::Model::Serialize::LAZY_EMPTY_COLLECTION) &&
508
+ (value.nil? || Lutaml::Model::Utils.uninitialized?(value))
509
+ else
510
+ @#{name} = value
511
+ end
512
+ record_mutation_collection(:#{name}, value)
513
+ end
514
+ RUBY
515
+ elsif attr.collection?
516
+ # Lazy-seeded default collections (#1010): a nil write is a
517
+ # real state here (initialize_empty reads nil after an
518
+ # explicit nil value), so it must land over the sentinel
519
+ # instead of preserving it.
520
+ class_eval(<<~RUBY, __FILE__, __LINE__ + 1) # rubocop:disable Style/DocumentDynamicEvalDefinition
521
+ def #{name}=(value)
522
+ value_set_for(:#{name})
523
+ value = __attribute_definition_#{name}.cast_value(value, lutaml_register)
524
+ @#{name} = value
525
+ record_mutation_collection(:#{name}, value)
526
+ end
527
+
528
+ def __assign_parsed_#{name}=(value)
529
+ value_set_for(:#{name})
530
+ @#{name} = value
531
+ record_mutation_collection(:#{name}, value)
532
+ end
533
+ RUBY
534
+ else
535
+ class_eval(<<~RUBY, __FILE__, __LINE__ + 1) # rubocop:disable Style/DocumentDynamicEvalDefinition
536
+ def #{name}=(value)
537
+ value_set_for(:#{name})
538
+ value = __attribute_definition_#{name}.cast_value(value, lutaml_register)
539
+ @#{name} = value
540
+ record_mutation(:#{name}, value)
541
+ end
542
+
543
+ # TODO.max-perf/31: see the collection branch above.
544
+ def __assign_parsed_#{name}=(value)
545
+ value_set_for(:#{name})
546
+ @#{name} = value
547
+ record_mutation(:#{name}, value)
548
+ end
549
+ RUBY
550
+ end
551
+ end
552
+
553
+ # Block form of the compiled getter in define_regular_attribute_methods,
554
+ # for runtimes without a source compiler (see source_compilation?).
555
+ def define_block_attribute_getter(name, attr)
556
+ name = name.to_sym # the compiled form passes :name literals
557
+ ivar = :"@#{name}"
558
+ if attr.collection?
559
+ # The compiled getter resolves Array in the model class's scope.
560
+ scope = self
561
+ define_method(name) do |arg = Lutaml::Model::Serialize::NO_ARG|
562
+ if arg.equal?(Lutaml::Model::Serialize::NO_ARG)
563
+ materialize_lazy_collection(name)
564
+ else
565
+ current = IVAR_GET.bind_call(self, ivar) || []
566
+ new_value = current.is_a?(CONST_GET.bind_call(scope, :Array)) ? current + [arg] : arg
567
+ IVAR_SET.bind_call(self, ivar, new_value)
568
+ record_mutation(name, arg)
569
+ arg
570
+ end
571
+ end
572
+ else
573
+ define_method(name) do |arg = Lutaml::Model::Serialize::NO_ARG|
574
+ if arg.equal?(Lutaml::Model::Serialize::NO_ARG)
575
+ IVAR_GET.bind_call(self, ivar)
576
+ else
577
+ public_send(:"#{name}=", arg)
578
+ arg
579
+ end
580
+ end
581
+ end
582
+ end
583
+
584
+ # Block form of the compiled setters in define_regular_attribute_methods.
585
+ # The Attribute is read through the same hidden accessor the
586
+ # compiled form calls, not captured: a setter redefined over an
587
+ # enum shorthand keeps casting with the accessor's Attribute.
588
+ def define_block_attribute_setters(name, attr)
589
+ name = name.to_sym # the compiled form passes :name literals
590
+ ivar = :"@#{name}"
591
+ handle = :"__attribute_definition_#{name}"
592
+ if attr.collection? && !attr.lazy_collection_default?
593
+ assign = lambda do |model, value|
594
+ current = IVAR_GET.bind_call(model, ivar)
595
+ unless current.equal?(Lutaml::Model::Serialize::LAZY_EMPTY_COLLECTION) &&
596
+ (value.nil? || Lutaml::Model::Utils.uninitialized?(value))
597
+ IVAR_SET.bind_call(model, ivar, value)
598
+ end
599
+ SEND.bind_call(model, :record_mutation_collection, name, value)
600
+ end
601
+ define_method(:"#{name}=") do |value|
602
+ value_set_for(name)
603
+ assign.call(self, SEND.bind_call(self, handle).cast_value(value, lutaml_register))
604
+ end
605
+ define_method(:"__assign_parsed_#{name}=") do |value|
606
+ value_set_for(name)
607
+ assign.call(self, value)
608
+ end
609
+ elsif attr.collection?
610
+ # Lazy-seeded default collections (#1010): nil lands over the
611
+ # sentinel — see the source-compiled branch.
612
+ assign = lambda do |model, value|
613
+ IVAR_SET.bind_call(model, ivar, value)
614
+ SEND.bind_call(model, :record_mutation_collection, name, value)
615
+ end
616
+ define_method(:"#{name}=") do |value|
617
+ value_set_for(name)
618
+ assign.call(self, SEND.bind_call(self, handle).cast_value(value, lutaml_register))
619
+ end
620
+ define_method(:"__assign_parsed_#{name}=") do |value|
621
+ value_set_for(name)
622
+ assign.call(self, value)
623
+ end
624
+ else
625
+ define_method(:"#{name}=") do |value|
626
+ value_set_for(name)
627
+ value = SEND.bind_call(self, handle).cast_value(value, lutaml_register)
628
+ IVAR_SET.bind_call(self, ivar, value)
629
+ record_mutation(name, value)
630
+ end
631
+ define_method(:"__assign_parsed_#{name}=") do |value|
632
+ value_set_for(name)
633
+ IVAR_SET.bind_call(self, ivar, value)
634
+ record_mutation(name, value)
635
+ end
636
+ end
637
+ end
638
+
639
+ # Class-level documentation metadata (#356): `desc "text"` on
640
+ # the model class; a zero-argument call reads it back.
641
+ # Subclasses inherit the nearest ancestor's description — an
642
+ # explicit `desc` overrides. Consumed by documentation and
643
+ # schema tooling; the serialization paths never read it.
644
+ def desc(text = nil)
645
+ return @lutaml_desc = text if text
646
+
647
+ return @lutaml_desc if defined?(@lutaml_desc)
648
+
649
+ if superclass.is_a?(::Class) &&
650
+ superclass < ::Lutaml::Model::Serializable
651
+ superclass.desc
652
+ end
653
+ end
654
+
655
+ # Model evolution (#265): `version 1` (or a semver string)
656
+ # stamps the model schema version. Subclasses inherit the
657
+ # nearest ancestor's version; a family is the ancestor chain of
658
+ # version-declared classes, and detection routes within it.
659
+ def version(value = nil)
660
+ return @lutaml_model_version = value if value
661
+
662
+ return @lutaml_model_version if defined?(@lutaml_model_version)
663
+
664
+ if superclass.is_a?(::Class) &&
665
+ superclass < ::Lutaml::Model::Serializable
666
+ return superclass.version
667
+ end
668
+
669
+ nil
670
+ end
671
+
672
+ alias model_version version
673
+
674
+ # Wire-level version detection for the family (#265): the block
675
+ # receives the parsed document hash and returns the version the
676
+ # document was written against. Declared on the family head;
677
+ # `from_<format>` routes to the detected version's class before
678
+ # parsing. Opt-in — without a detector, parsing is unchanged.
679
+ def detect_version(&block)
680
+ return @lutaml_version_detector = block if block
681
+
682
+ return @lutaml_version_detector if defined?(@lutaml_version_detector)
683
+
684
+ if superclass.is_a?(::Class) &&
685
+ superclass < ::Lutaml::Model::Serializable
686
+ return superclass.detect_version
687
+ end
688
+
689
+ nil
690
+ end
691
+
692
+ # Declares wire-level migration steps from a former model
693
+ # version (#265). The block is evaluated on an EvolutionSteps
694
+ # collector (wire_rename, wire_move, wire_merge, wire_drop);
695
+ # the steps are applied by `evolve`, in declaration order, to a
696
+ # copy of the source document's wire hash before the target
697
+ # model parses it.
698
+ def evolution(from:, &block)
699
+ unless from.is_a?(::Class) && from < ::Lutaml::Model::Serializable
700
+ raise ArgumentError,
701
+ "evolution from: must be a Lutaml::Model::Serializable " \
702
+ "model class"
703
+ end
704
+
705
+ collector = Lutaml::Model::EvolutionSteps.new
706
+ collector.instance_eval(&block)
707
+ lutaml_evolutions[from] = collector.steps.freeze
708
+ nil
709
+ end
710
+
711
+ def lutaml_evolutions
712
+ @lutaml_evolutions ||= {}
713
+ end
714
+
715
+ # The class of the family that declares `version == value`.
716
+ # Walks the ancestor chain nearest-first; raises
717
+ # UnsupportedVersionError when no family member declares it.
718
+ def version_class_for(value)
719
+ klass = self
720
+ while klass.is_a?(::Class) &&
721
+ klass < ::Lutaml::Model::Serializable
722
+ return klass if klass.version == value
723
+
724
+ klass = klass.superclass
725
+ end
726
+
727
+ raise ::Lutaml::Model::UnsupportedVersionError.new(self, value)
728
+ end
729
+
730
+ # Migrate a document or instance of a former model version into
731
+ # this one (#265). The source's wire hash (its own `to_hash`
732
+ # for an instance) passes through the declared evolution chain
733
+ # — every family link between the source version and this
734
+ # class, in order — and the result parses as this model.
735
+ #
736
+ # @param source [Hash, Serializable] the old document or model
737
+ # @param from [Class] the source model class
738
+ # @param format [Symbol] the key-value format used to parse
739
+ # the evolved hash
740
+ def evolve(source, from:)
741
+ chain = evolution_chain_from(from)
742
+ wire = if source.is_a?(::Hash)
743
+ Lutaml::Model::Utils.deep_dup(source)
744
+ else
745
+ source.to_hash
746
+ end
747
+ chain.each do |link_source|
748
+ steps = evolution_steps_for(link_source)
749
+ wire = steps.reduce(wire) { |hash, step| step.call(hash) }
750
+ end
751
+ from_hash(wire)
752
+ end
753
+
754
+ # Family members nearest-first, self included.
755
+ def evolution_family
756
+ members = []
757
+ klass = self
758
+ while klass.is_a?(::Class) &&
759
+ klass < ::Lutaml::Model::Serializable
760
+ members << klass
761
+ klass = klass.superclass
762
+ end
763
+ members
764
+ end
765
+
766
+ # Shortest declared-evolution path from the source class to
767
+ # self, as the list of link source classes. Edges are the
768
+ # family's `evolution from:` declarations. (Public: also serves
769
+ # introspection of declared family links.)
770
+ def evolution_chain_from(source_class)
771
+ return [] if source_class == self
772
+
773
+ edges = {}
774
+ evolution_family.each do |member|
775
+ member.lutaml_evolutions.each_key do |source|
776
+ (edges[source] ||= []) << member
777
+ end
778
+ end
779
+
780
+ parents = { source_class => nil }
781
+ frontier = [source_class]
782
+ until frontier.empty? || parents[self]
783
+ current = frontier.shift
784
+ (edges[current] || []).each do |target|
785
+ next if parents.key?(target)
786
+
787
+ parents[target] = current
788
+ frontier << target
789
+ end
790
+ end
791
+
792
+ unless parents[self]
793
+ raise ArgumentError,
794
+ "no evolution path from #{source_class} to #{self} " \
795
+ "is declared"
796
+ end
797
+
798
+ path = []
799
+ cursor = self
800
+ while cursor != source_class
801
+ path.unshift(cursor)
802
+ cursor = parents[cursor]
803
+ end
804
+ path.unshift(source_class)[0...-1]
805
+ end
806
+
807
+ # The family member (nearest-first) that declared steps for the
808
+ # given link source.
809
+ def evolution_steps_for(link_source)
810
+ member = evolution_family.find do |klass|
811
+ klass.lutaml_evolutions.key?(link_source)
812
+ end
813
+ member.lutaml_evolutions[link_source]
814
+ end
815
+
816
+ # Define an attribute for the model
817
+ #
818
+ # @param name [Symbol] The attribute name
819
+ # @param type [Class, Symbol, Hash] The attribute type
820
+ # @param options [Hash] Attribute options
821
+ # @return [Attribute] The created attribute
822
+ def attribute(name, type, options = {})
823
+ type, options = process_type_hash(type, options) if type.is_a?(::Hash)
824
+
825
+ if type.is_a?(::Array)
826
+ options = options.merge(union_member_types: type)
827
+ type = Lutaml::Model::Type::Union
828
+ end
829
+
830
+ # Handle direct method option in options hash
831
+ if options[:method]
832
+ options[:method_name] = options.delete(:method)
833
+ end
834
+
835
+ attr = Attribute.new(name, type, options)
836
+ lutaml_cow_fork!(:attributes)
837
+ @attributes[name] = attr
838
+ @merged_attributes_cache = nil
839
+ # Attributes can be declared after the model has been
840
+ # instantiated (forward references, post-hoc declarations);
841
+ # the interned writer table from the first instantiation must
842
+ # not outlive the attribute set it was built from.
843
+ @instantiate_writers = nil
844
+ invalidate_state_defaults!
845
+ define_attribute_methods(attr)
846
+
847
+ attr
848
+ end
849
+
850
+ # Restrict options on an existing attribute
851
+ #
852
+ # @param name [Symbol] The attribute name to restrict
853
+ # @param options [Hash] New options to merge
854
+ # @return [Symbol] The attribute name
855
+ def restrict(name, options = {})
856
+ register_id = options.delete(:register) || Lutaml::Model::Config.default_register
857
+ lutaml_cow_fork!(:attributes)
858
+ lutaml_cow_fork!(:registers)
859
+
860
+ if !@attributes.key?(name) && !register_record(register_id)&.dig(
861
+ :attributes, name
862
+ )
863
+ return restrict_attributes[name] = options if any_importable_models?
864
+
865
+ raise Lutaml::Model::UndefinedAttributeError.new(name, self)
866
+ end
867
+
868
+ validate_attribute_options!(name, options)
869
+ attr = attributes(register_id)[name]
870
+ attr.options.merge!(options)
871
+ attr.process_options!
872
+ name
873
+ end
874
+
875
+ # Check if there are any importable models
876
+ #
877
+ # @return [Boolean] True if there are pending imports
878
+ def any_importable_models?
879
+ importable_choices.any? || importable_models.any?
880
+ end
881
+
882
+ # Validate attribute options
883
+ #
884
+ # @param name [Symbol] The attribute name
885
+ # @param options [Hash] The options to validate
886
+ # @raise [InvalidAttributeOptionsError] If invalid options are present
887
+ def validate_attribute_options!(name, options)
888
+ invalid_opts = options.keys - Attribute::ALLOWED_OPTIONS
889
+ return if invalid_opts.empty?
890
+
891
+ raise Lutaml::Model::InvalidAttributeOptionsError.new(name,
892
+ invalid_opts)
893
+ end
894
+ end
895
+ end
896
+ end
897
+ end