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,1223 @@
1
+ module Lutaml
2
+ module KeyValue
3
+ MISSING = Object.new.freeze
4
+ class Transform < Lutaml::Model::Transform
5
+ def data_to_model(data, format, options = {})
6
+ # Use child's own default register if it has one
7
+ # This ensures versioned schemas (e.g., MML v2 with lutaml_default_register = :mml_v2)
8
+ # are instantiated with their native context
9
+ # TODO.max-perf/32: constant per (model class, register) — the
10
+ # transform itself is cached per that pair, so resolve once.
11
+ child_register = @kv_child_register ||= Lutaml::Model::Register
12
+ .resolve_for_child(
13
+ model_class, lutaml_register
14
+ )
15
+
16
+ # TODO.max-perf/37: eligible models hydrate in one pass —
17
+ # collect raw values per rule, recurse into eligible child
18
+ # models, build every instance through the bulk constructor.
19
+ # Falls back to the per-rule walk for anything ineligible.
20
+ if !options.key?(:mappings) && data.is_a?(::Hash) &&
21
+ %i[json yaml toml hash].include?(format) &&
22
+ (group = self.class.kv_group_plan(model_class, format,
23
+ lutaml_register)) &&
24
+ (instance = kv_group_build(group, data, format, child_register,
25
+ options))
26
+ root_and_parent_assignment(instance, options)
27
+ return instance
28
+ end
29
+
30
+ if model_class.include?(Lutaml::Model::Serialize)
31
+ # #1003: constructor-equivalent state via the compiled walk
32
+ # seed — no per-attribute determine_value walk per instance.
33
+ instance = model_class.allocate_for_walk(child_register)
34
+ else
35
+ instance = model_class.new
36
+ register_accessor_methods_for(instance, child_register)
37
+ end
38
+ root_and_parent_assignment(instance, options)
39
+ mappings = extract_mappings(options, format)
40
+
41
+ rules = mappings.mappings(lutaml_register)
42
+ # lutaml-model#88: nil unless the mapping partitions a wire key
43
+ # with when_attribute rules — the common case pays one scan.
44
+ partition = kv_partition(rules)
45
+ rules.each do |rule|
46
+ process_mapping_rule(data, instance, format, rule, options, partition)
47
+ end
48
+ collect_unmapped_keys(data, instance, mappings, rules)
49
+
50
+ instance
51
+ end
52
+
53
+ # #985: with `map_unmapped to:` declared, document keys no rule
54
+ # claims are collected verbatim into the target attribute, exactly
55
+ # as the model would have kept them outside a mapping.
56
+ def collect_unmapped_keys(data, instance, mappings, rules)
57
+ return unless data.is_a?(::Hash)
58
+
59
+ target = validated_unmapped_target(mappings)
60
+ return if target.nil?
61
+
62
+ claimed = {}
63
+ rules.each do |rule|
64
+ Array(rule.name).each { |name| claimed[name.to_s] = true } if rule.name
65
+ end
66
+
67
+ extras = nil
68
+ data.each do |key, value|
69
+ next if claimed[key.to_s]
70
+
71
+ (extras ||= {})[key] = value
72
+ end
73
+ return if extras.nil?
74
+
75
+ existing = instance.public_send(target)
76
+ merged = existing.is_a?(::Hash) ? existing.merge(extras) : extras
77
+ instance.public_send(:"#{target}=", merged)
78
+ end
79
+
80
+ # Memoized on the cached transform (one instance per model class
81
+ # and register): a typo'd map_unmapped target raises at first
82
+ # parse, naming the class and the target, instead of NoMethodError
83
+ # from inside the walk.
84
+ def validated_unmapped_target(mappings)
85
+ target = mappings.unmapped_attribute
86
+ return if target.nil?
87
+ return @lutaml_unmapped_target if @lutaml_unmapped_target == target
88
+
89
+ unless model_class.attributes(lutaml_register).key?(target)
90
+ raise ArgumentError,
91
+ "map_unmapped target :#{target} is not a declared " \
92
+ "attribute of #{model_class}"
93
+ end
94
+
95
+ @lutaml_unmapped_target = target
96
+ end
97
+
98
+ def model_to_data(instance, format, options = {})
99
+ # NEW ARCHITECTURE: Use KeyValue::Transformation if available
100
+ # This provides symmetric OOP architecture with XmlDataModel
101
+ if context.is_a?(Class) && context.include?(Lutaml::Model::Serialize)
102
+ transformation = context.transformation_for(
103
+ format, lutaml_register, mapping: @lutaml_mapping_override
104
+ )
105
+
106
+ # transformation_for returns nil for cyclic dependencies or :building sentinel
107
+ # Fall back to legacy approach in these cases
108
+ if transformation.is_a?(Lutaml::KeyValue::Transformation)
109
+ # transform emits the output hash directly (TODO.perf 19)
110
+ return transformation.transform(instance, options)
111
+ end
112
+ end
113
+
114
+ # LEGACY ARCHITECTURE: Fall back to Hash-based approach
115
+ # This maintains backward compatibility for models without transformations
116
+ mappings = extract_mappings(options, format)
117
+
118
+ rules = mappings.mappings(lutaml_register)
119
+ partition = kv_partition(rules)
120
+ hash = {}
121
+ handled_groups = nil
122
+ rules.each do |rule|
123
+ next unless valid_mapping?(rule, options)
124
+
125
+ group = partition && kv_partition_group(rule, partition)
126
+ if group
127
+ next if handled_groups&.include?(group)
128
+
129
+ (handled_groups ||= []) << group
130
+ process_partition_group!(instance, group, hash, format, options)
131
+ else
132
+ process_rule!(instance, rule, hash, format, mappings, options)
133
+ end
134
+ end
135
+ merge_unmapped_on_serialize(instance, mappings, hash)
136
+
137
+ hash.keys == [""] ? hash[""] : hash
138
+ end
139
+
140
+ # #985: re-emit the collected unknown keys after the mapped rules,
141
+ # so a mapped key colliding with a collected one wins. The
142
+ # attribute was declared in the mapping and validated at compile,
143
+ # so the accessor exists on every instance shape.
144
+ def merge_unmapped_on_serialize(instance, mappings, hash)
145
+ target = mappings.unmapped_attribute
146
+ return if target.nil?
147
+
148
+ extras = instance.public_send(target)
149
+ extras.each { |key, value| hash[key] ||= value } if extras.is_a?(::Hash)
150
+ end
151
+
152
+ # ---- TODO.max-perf/37: group-then-instantiate fast path ----
153
+
154
+ # [model class, format, register] -> rows or false (ineligible).
155
+ # Rows: [[rule, attr, kind, child_rows]] with kind :scalar or
156
+ # :model; child_rows is the child model's own row set. Cycle-safe:
157
+ # an in-progress model resolves false, so self-referential models
158
+ # take the interpretive walk.
159
+ # Concurrent::Map under threaded MRI, plain Hash under Opal
160
+ # (Concurrent is unavailable there) — the RULE_RECORDS pattern.
161
+ # Writes are idempotent (the same deterministic plan is computed),
162
+ # so a lost race costs a duplicate build, never a wrong value.
163
+ KV_GROUP_PLANS = if Lutaml::Model.opal?
164
+ {}
165
+ else
166
+ Lutaml::Model::RuntimeCompatibility
167
+ .require_native("concurrent")
168
+ Concurrent::Map.new
169
+ end
170
+
171
+ # [model class, register, format, generation] -> { rule => plan }.
172
+ # Class-level, generation-retired: the whole dispatch table for a
173
+ # model mapping compiles once — kind (scalar/custom/hash_map/
174
+ # interpretive/skip/invalid), target attribute and validity — so
175
+ # process_mapping_rule stops re-probing rule predicates at every
176
+ # node (~12 predicate calls plus a key array per rule per node;
177
+ # 154k+154k allocations per heroku.json parse). Same
178
+ # idempotent-write pattern as KV_GROUP_PLANS.
179
+ KV_WALK_PLANS = if Lutaml::Model.opal?
180
+ {}
181
+ else
182
+ Lutaml::Model::RuntimeCompatibility
183
+ .require_native("concurrent")
184
+ Concurrent::Map.new
185
+ end
186
+
187
+ def self.kv_group_plan(model_class, format, register)
188
+ # Context generation: specs (and apps) reset registers between
189
+ # parses; a plan cached across a reset references dead attribute
190
+ # objects. The generation key retires stale plans for free.
191
+ key = [model_class, format, register,
192
+ Lutaml::Model::GlobalContext.context_generation]
193
+ plan = KV_GROUP_PLANS[key]
194
+ return plan unless plan.nil?
195
+
196
+ # Cycle detection rides a THREAD-LOCAL recursion stack: a shared
197
+ # in-progress set races (a concurrent same-key build would cache
198
+ # false permanently), and the stack is per-build by definition.
199
+ # The false at the cycle point is NOT cached — the outermost
200
+ # build completes and caches the model's real verdict.
201
+ stack = (Thread.current[:kv_group_plan_stack] ||= [])
202
+ return false if stack.include?(key)
203
+
204
+ stack.push(key)
205
+ begin
206
+ KV_GROUP_PLANS[key] = build_kv_group_plan(model_class, format,
207
+ register)
208
+ ensure
209
+ stack.pop
210
+ end
211
+ end
212
+
213
+ def self.build_kv_group_plan(model_class, format, register)
214
+ return false unless model_class.is_a?(Class) &&
215
+ model_class.include?(Lutaml::Model::Serialize)
216
+
217
+ mapping = model_class.mappings_for(format, register)
218
+ return false if mapping.nil?
219
+
220
+ attrs = model_class.attributes(register)
221
+ # The catch-all compiles as a row: unclaimed document keys are
222
+ # collected into the target attribute after the rules hydrate,
223
+ # mirroring the interpretive collect's position and merge. A
224
+ # typo'd target raises here, exactly as the walk raises at
225
+ # first parse.
226
+ unmapped_target = mapping.unmapped_attribute
227
+ if unmapped_target && !attrs.key?(unmapped_target)
228
+ raise ArgumentError,
229
+ "map_unmapped target :#{unmapped_target} is not a " \
230
+ "declared attribute of #{model_class}"
231
+ end
232
+ rows = nil
233
+ claimed = nil
234
+ mapping.mappings(register).each do |rule|
235
+ eligible = !rule.name.nil? && !rule.multiple_mappings? &&
236
+ rule.delegate.nil? &&
237
+ !rule.has_custom_method_for_deserialization? &&
238
+ !rule.raw_mapping? && !rule.root_mapping? &&
239
+ rule.when_attribute.empty? &&
240
+ !(if rule.polymorphic.is_a?(::Hash)
241
+ !rule.polymorphic.empty?
242
+ else
243
+ !!rule.polymorphic
244
+ end) &&
245
+ rule.transform.is_a?(::Hash) && rule.transform.empty? &&
246
+ rule.value_map(:from) ==
247
+ Lutaml::Model::Serialize::DEFAULT_VALUE_MAP
248
+ return false unless eligible
249
+
250
+ attr = attrs[rule.to]
251
+ return false if attr.nil? || attr.derived?
252
+ # Declared ranges keep their eager validation on the
253
+ # interpretive walk; polymorphic/union/custom-collection
254
+ # dispatch and registered type substitutions own their cast
255
+ # (the per-rule walk threads them through cast options).
256
+ return false if attr.collection? && attr.collection.is_a?(Range)
257
+ return false if attr.polymorphic? || attr.union? ||
258
+ attr.custom_collection?
259
+
260
+ type = attr.type(register)
261
+ return false if Lutaml::Model::GlobalContext.context(register)
262
+ .substitution_for(type).any?
263
+
264
+ if rule.hash_mappings
265
+ # #1003: compiled child-map row. The compiled ChildMapPlan
266
+ # reproduces translate_mappings' per-child lookups; shapes
267
+ # the compile cannot cover (unmappable child attribute,
268
+ # singular target, non-model child type) keep the whole
269
+ # model interpretive.
270
+ return false unless attr.collection? &&
271
+ type.is_a?(Class) && type.include?(Lutaml::Model::Serialize)
272
+
273
+ child_plan = compile_group_child_plan(type, format, register,
274
+ rule.hash_mappings)
275
+ return false unless child_plan
276
+
277
+ rows ||= []
278
+ rows << [rule, attr, :child_map, child_plan, nil, nil]
279
+ next
280
+ end
281
+
282
+ if type.is_a?(Class) && type.include?(Lutaml::Model::Serialize)
283
+ child_register = Lutaml::Model::Register
284
+ .resolve_for_child(type, register)
285
+ child_rows = kv_group_plan(type, format, child_register)
286
+ return false unless child_rows
287
+
288
+ rows ||= []
289
+ # child_register rides the row: the plan was BUILT under it,
290
+ # and rebuilding the resolution per model row per document
291
+ # cost a Concurrent::Map hop each time (TODO.perf 14).
292
+ rows << [rule, attr, :model, type, child_rows, child_register]
293
+ elsif type.is_a?(Class) && type < Lutaml::Model::Type::Value &&
294
+ !attr.value_policy.whole_value?(type) &&
295
+ !Lutaml::Model::Attribute.custom_from_probe?(type)
296
+ rows ||= []
297
+ rows << [rule, attr, :scalar, nil, nil, nil]
298
+ else
299
+ return false
300
+ end
301
+ end
302
+ if unmapped_target
303
+ claimed = {}
304
+ mapping.mappings(register).each do |rule|
305
+ Array(rule.name).each { |name| claimed[name.to_s] = true } if rule.name
306
+ end
307
+ claimed.freeze
308
+ (rows ||= []) << [nil, nil, :unmapped, unmapped_target, claimed,
309
+ nil]
310
+ end
311
+ # No eligible rows at all (empty mapping) — nothing to gain.
312
+ rows
313
+ end
314
+
315
+ # Class-level twin of the walk's child-map compile: the registry
316
+ # lookups (child rules, per-attribute wire names, path casts)
317
+ # resolve once per plan instead of once per node per child. nil
318
+ # keeps the model interpretive (preserving the walk's raise
319
+ # timing for declaration errors).
320
+ def self.compile_group_child_plan(child_class, format, register,
321
+ child_mappings)
322
+ child_rules = child_class.mappings_for(format, register)
323
+ wire_names = {}
324
+ paths = {}
325
+ child_mappings.each do |attr_name, path|
326
+ attr_rule = child_rules.find_by_to!(attr_name)
327
+ wire_names[attr_name] = attr_rule.from.to_s
328
+ paths[attr_name] = case path
329
+ when :key then :key
330
+ when :value then :value
331
+ else Array(path).map(&:to_s).freeze
332
+ end
333
+ end
334
+ ChildMapPlan.new(child_mappings, wire_names, paths,
335
+ child_mappings.values == [:key], child_rules,
336
+ child_class)
337
+ rescue Lutaml::Model::NoMappingFoundError
338
+ nil
339
+ end
340
+
341
+ # Build values bottom-up, then ONE instance per model: present
342
+ # keys through the casting setters, ABSENT rules through the real
343
+ # per-rule walk (their extractor/defaults/sentinel semantics are
344
+ # the walk's own — reproducing them here would fork them). The
345
+ # per-rule walk is eliminated exactly for the present-key hot
346
+ # path. Returns nil (caller falls back) on any shape the plan
347
+ # does not cover, e.g. a non-Hash item where a model was expected.
348
+ def kv_group_build(rows, doc, format, register, options)
349
+ # Positional values, not per-row [name, value] pairs: rows are a
350
+ # fixed per-class list, so the writer to apply lives at the row's
351
+ # index and the pair arrays were the lane's biggest allocation
352
+ # (~6 arrays per node on hydrate-heavy corpora).
353
+ values = Array.new(rows.size, MISSING)
354
+ children = []
355
+ # Lazy: the present-key hot path never pushes, and this runs
356
+ # once per hydrated model instance.
357
+ absent = nil
358
+ unmapped = nil
359
+ i = 0
360
+ rows.each do |rule, attr, kind, type, child_rows, child_register|
361
+ if kind == :unmapped
362
+ unmapped = [type, child_rows]
363
+ i += 1
364
+ next
365
+ end
366
+
367
+ # One hash pass per row: fetch with a sentinel distinguishes
368
+ # absent keys from present-nil values (both read as nil), so
369
+ # the separate string_or_symbol_key? probe goes away.
370
+ v = Lutaml::Model::Utils.fetch_str_or_sym(doc, rule.name, MISSING)
371
+ if v.equal?(MISSING)
372
+ (absent ||= []) << rule
373
+ i += 1
374
+ next
375
+ end
376
+
377
+ if kind == :child_map
378
+ # Compiled translate_mappings (#1003): per-child lookups
379
+ # are plan constants. Children hydrate through their own
380
+ # compiled walk (the mappings: option routes them there);
381
+ # parent/root wiring rides the shared children pass. A
382
+ # non-Hash value falls back to the walk, which owns that
383
+ # error.
384
+ return nil unless v.is_a?(::Hash)
385
+
386
+ built = []
387
+ keys_only = type.keys_only && v.values.all?(::Hash)
388
+ v.each do |child_key, child_value|
389
+ child_hash = {}
390
+ type.child_mappings.each_key do |attr_name|
391
+ child_hash[type.wire_names[attr_name]] =
392
+ extract_compiled_child_value(type.paths[attr_name],
393
+ child_key, child_value)
394
+ end
395
+ child_hash.update(child_value) if keys_only
396
+ built << self.class.data_to_model(type.attr_type,
397
+ child_hash, format, { mappings: type.child_rules })
398
+ end
399
+ values[i] = built
400
+ children.concat(built)
401
+ i += 1
402
+ next
403
+ end
404
+
405
+ if kind == :scalar
406
+ values[i] = v
407
+ i += 1
408
+ next
409
+ end
410
+
411
+ if attr.collection?
412
+ # A present-but-nil collection reaches the per-rule walk,
413
+ # which owns the sentinel interplay for that edge
414
+ # (render_nil :as_empty semantics).
415
+ return nil if v.nil?
416
+
417
+ items = v.is_a?(::Array) ? v : [v]
418
+ built = []
419
+ items.each do |item|
420
+ return nil unless item.is_a?(::Hash)
421
+
422
+ child = self.class.kv_group_instance(type, child_rows, item,
423
+ format, child_register,
424
+ options)
425
+ return nil if child.nil?
426
+
427
+ built << child
428
+ end
429
+ values[i] = built
430
+ children.concat(built)
431
+ else
432
+ return nil unless v.is_a?(::Hash)
433
+
434
+ child = self.class.kv_group_instance(type, child_rows, v,
435
+ format, child_register,
436
+ options)
437
+ return nil if child.nil?
438
+
439
+ values[i] = child
440
+ children << child
441
+ end
442
+ i += 1
443
+ end
444
+ instance = model_class.allocate_for_walk(register)
445
+ i = 0
446
+ rows.each do |rule, _attr, kind, *_rest|
447
+ v = values[i]
448
+ i += 1
449
+ next if v.equal?(MISSING) || kind == :unmapped
450
+
451
+ instance.public_send(rule.kv_setter, v)
452
+ end
453
+ absent&.each do |rule|
454
+ process_mapping_rule(doc, instance, format, rule, options, nil)
455
+ end
456
+ children.each do |child|
457
+ child.lutaml_parent = instance
458
+ child.lutaml_root ||= instance.lutaml_root || instance
459
+ end
460
+ if unmapped
461
+ target, claimed = unmapped
462
+ extras = nil
463
+ doc.each do |key, value|
464
+ next if claimed.key?(key.to_s)
465
+
466
+ (extras ||= {})[key] = value
467
+ end
468
+ if extras
469
+ existing = instance.public_send(target)
470
+ merged = existing.is_a?(::Hash) ? existing.merge(extras) : extras
471
+ instance.public_send(:"#{target}=", merged)
472
+ end
473
+ end
474
+ instance
475
+ end
476
+
477
+ def self.kv_group_instance(model_class, rows, doc, format, register,
478
+ options)
479
+ # cached_transform is per (class, register); format rides the
480
+ # call, not the cache.
481
+ cached_transform(model_class, register)
482
+ .kv_group_build(rows, doc, format, register, options)
483
+ end
484
+
485
+ private
486
+
487
+ def process_rule!(instance, rule, hash, format, _mappings, options)
488
+ return handle_delegate(instance, rule, hash, format) if rule.delegate
489
+
490
+ process_mapping_for_instance(instance, hash, format, rule, options)
491
+ end
492
+
493
+ def process_mapping_for_instance(instance, hash, format, rule, options)
494
+ if rule.custom_methods[:to]
495
+ to_method = rule.custom_methods[:to]
496
+ # lutaml-model#550: custom methods may declare a third context
497
+ # parameter to receive the options passed to `to_*`.
498
+ if Lutaml::Model::MappingRule.custom_method_arity(instance.class, to_method).to_i >= 3
499
+ return instance.public_send(to_method, instance, hash,
500
+ options[:context])
501
+ end
502
+
503
+ return instance.public_send(to_method, instance, hash)
504
+ end
505
+
506
+ attribute = attributes[rule.to]
507
+
508
+ # TODO.max-perf/10: plain scalar/collection rules take a fast
509
+ # lane — memoized wire name, shared render? semantics, one
510
+ # serialize dispatch — collapsing the interpretive branch
511
+ # probes below. Rules with any special feature stay on the
512
+ # full path.
513
+ if (plan = kv_serialize_plan(rule, attribute, instance))
514
+ value = instance.public_send(attribute.name)
515
+ if rule.render?(value, instance)
516
+ hash[plan.wire] = attribute.serialize(value, format,
517
+ lutaml_register, options)
518
+ end
519
+ return
520
+ end
521
+
522
+ value = rule.serialize(instance)
523
+
524
+ if rule.can_transform_to?(attribute, format)
525
+ hash[rule_from_name(rule)] =
526
+ rule.transform_value(attribute, value, :to, format)
527
+ return
528
+ end
529
+
530
+ if rule.raw_mapping?
531
+ return handle_raw_mapping(hash, value, format,
532
+ options)
533
+ end
534
+ if rule.root_mapping?
535
+ return handle_root_mappings(hash, value, format, rule,
536
+ attribute)
537
+ end
538
+
539
+ # Use the format parameter passed in instead of hardcoding to :json
540
+ value = ExportTransformer.call(value, rule, attribute,
541
+ format: format,
542
+ context: options[:context])
543
+
544
+ value = serialize_value(value, rule, attribute, format, options)
545
+
546
+ return unless rule.render?(value, instance)
547
+
548
+ value = apply_value_map(value, rule.value_map(:to, options), attribute)
549
+
550
+ hash[rule_from_name(rule)] = value
551
+ end
552
+
553
+ def valid_mapping?(rule, options)
554
+ # rule is always Lutaml::Model::MappingRule; serialize? is
555
+ # statically defined (the hydrate-only marker).
556
+ return false unless rule.serialize?
557
+
558
+ only = options[:only]
559
+ except = options[:except]
560
+ name = rule.to
561
+
562
+ (except.nil? || !except.include?(name)) &&
563
+ (only.nil? || only.include?(name))
564
+ end
565
+
566
+ def handle_raw_mapping(hash, value, format, options)
567
+ result = Lutaml::Model::Config.adapter_for(format).parse(value, options)
568
+
569
+ hash.merge!(result)
570
+ end
571
+
572
+ def handle_root_mappings(hash, value, format, rule, attr)
573
+ hash.merge!(
574
+ generate_hash_from_child_mappings(
575
+ attr,
576
+ value,
577
+ format,
578
+ rule.root_mappings,
579
+ ),
580
+ )
581
+ end
582
+
583
+ def serialize_value(value, rule, attr, format, options)
584
+ unless rule.child_mappings
585
+ return attr.serialize(value, format, lutaml_register,
586
+ options)
587
+ end
588
+
589
+ generate_hash_from_child_mappings(
590
+ attr, value, format, rule.child_mappings
591
+ )
592
+ end
593
+
594
+ def rule_from_name(rule)
595
+ rule.multiple_mappings? ? rule.from.first.to_s : rule.from.to_s
596
+ end
597
+
598
+ def generate_hash_from_child_mappings(attr, value, format, child_mappings)
599
+ return value unless child_mappings
600
+
601
+ hash = {}
602
+
603
+ generate_remaining_mappings_for_value(child_mappings, value, format)
604
+
605
+ attr_type = attr.type(lutaml_register)
606
+ rules = attr_type.mappings_for(format)
607
+ pairs = child_mappings.map do |attr_name, path|
608
+ [rules.find_by_to!(attr_name), path]
609
+ end
610
+
611
+ value.each do |child_obj|
612
+ hash.merge!(
613
+ extract_hash_for_child_mapping(pairs, child_obj, format),
614
+ )
615
+ end
616
+
617
+ hash
618
+ end
619
+
620
+ # Generates remaining child mappings for all attributes when only
621
+ # the :key mapping (e.g., { name: :key }) is provided.
622
+ # If any additional mappings (e.g., { name: :key, id: :identifier })
623
+ # are specified, no additional child mappings will be generated.
624
+ def generate_remaining_mappings_for_value(child_mappings, value, format)
625
+ return if child_mappings.values != [:key]
626
+
627
+ klass = value.first.class
628
+ mappings = klass.mappings_for(format, lutaml_register)
629
+
630
+ klass.attributes(lutaml_register).each_key do |name|
631
+ next if Utils.string_or_symbol_key?(child_mappings, name)
632
+
633
+ child_mappings[name.to_sym] = child_mapping_for(name, mappings)
634
+ end
635
+ end
636
+
637
+ def child_mapping_for(name, mappings)
638
+ mappings.find_by_to(name)&.name.to_s
639
+ end
640
+
641
+ def extract_hash_for_child_mapping(pairs, child_obj, format)
642
+ key = nil
643
+ value = {}
644
+
645
+ pairs.each do |rule, path|
646
+ attr_value = normalize_attribute_value(child_obj, rule, format)
647
+
648
+ next unless rule&.render?(attr_value, nil)
649
+ next key = attr_value if path == :key
650
+
651
+ value = extract_hash_value_for_child_mapping(path, attr_value, value)
652
+ end
653
+
654
+ value = nil if value.empty?
655
+ { key => value }
656
+ end
657
+
658
+ # The child's wire-form value for one attribute, produced through
659
+ # the same pipeline the child's own serializer uses for a rendered
660
+ # value (rule transform, then attribute serialization) — without
661
+ # the serialize-parse string round-trip this read previously paid
662
+ # per child per attribute.
663
+ def normalize_attribute_value(child_obj, rule, format)
664
+ child_attr = child_obj.class.attributes(lutaml_register)[rule.to]
665
+ value = child_obj.public_send(rule.to)
666
+ value = rule.transform_value(child_attr, value, :to, format)
667
+ child_attr.serialize(value, format, lutaml_register)
668
+ end
669
+
670
+ def extract_hash_value_for_child_mapping(path, value, map_value)
671
+ return value if path == :value
672
+
673
+ path = [path] unless path.is_a?(Array)
674
+ path[0...-1].inject(map_value) do |acc, k|
675
+ acc[k.to_s] ||= {}
676
+ end.public_send(:[]=, path.last.to_s, value)
677
+
678
+ map_value
679
+ end
680
+
681
+ def handle_delegate(instance, rule, hash, format)
682
+ value = extract_value_for_delegate(instance, rule)
683
+ return if value.nil? && rule.value_map(:to)[:nil] == :omitted
684
+
685
+ attribute = instance.public_send(rule.delegate).class.attributes(lutaml_register)[rule.to]
686
+ hash[rule_from_name(rule)] =
687
+ attribute.serialize(value, format, lutaml_register)
688
+ end
689
+
690
+ def extract_value_for_delegate(instance, rule)
691
+ instance.public_send(rule.delegate).public_send(rule.to)
692
+ end
693
+
694
+ def extract_mappings(options, format)
695
+ options[:mappings] || mappings_for(format, lutaml_register)
696
+ end
697
+
698
+ # ---- lutaml-model#88: when_attribute for key-value formats ----
699
+
700
+ # Wire keys partitioned by when_attribute rules: key -> { rules: all
701
+ # rules on the key in declaration order, discriminators: the subset
702
+ # carrying when_attribute }. nil unless any rule uses when_attribute.
703
+ def kv_partition(rules)
704
+ partitions = nil
705
+ rules.each do |rule|
706
+ next if rule.when_attribute.empty?
707
+
708
+ partitions ||= {}
709
+ key = kv_partition_key(rule)
710
+ entry = (partitions[key] ||= { rules: [], discriminators: [] })
711
+ entry[:discriminators] << rule
712
+ end
713
+ return nil unless partitions
714
+
715
+ rules.each do |rule|
716
+ key = kv_partition_key(rule)
717
+ partitions[key][:rules] << rule if partitions.key?(key)
718
+ end
719
+ partitions
720
+ end
721
+
722
+ def kv_partition_key(rule)
723
+ name = rule.name
724
+ name = name.first if name.is_a?(Array)
725
+ name.to_s
726
+ end
727
+
728
+ # The partition entry covering any of the rule's wire names.
729
+ def kv_partition_group(rule, partition)
730
+ return nil if partition.nil?
731
+
732
+ if rule.multiple_mappings?
733
+ rule.name.each do |name|
734
+ entry = partition[name.to_s]
735
+ return entry if entry
736
+ end
737
+ nil
738
+ else
739
+ partition[rule.name.to_s]
740
+ end
741
+ end
742
+
743
+ # A value at a partitioned key, filtered for one rule: a
744
+ # discriminator rule keeps its matches; a plain rule keeps the
745
+ # occurrences no discriminator claimed (single-capture, mirroring
746
+ # the XML side).
747
+ def apply_kv_when_attribute(value, rule, entry, attr = nil)
748
+ if rule.when_attribute.empty?
749
+ return kv_partition_value(value, attr) do |item|
750
+ entry[:discriminators].none? { |s| kv_item_matches?(item, s) }
751
+ end
752
+ end
753
+
754
+ plain_sibling = entry[:rules].any? { |r| r.when_attribute.empty? }
755
+ if rule.unmatched == :raise && !plain_sibling
756
+ check_unclaimed_kv_items!(value, rule, entry)
757
+ end
758
+ kv_partition_value(value, attr) { |item| kv_item_matches?(item, rule) }
759
+ end
760
+
761
+ def kv_item_matches?(item, rule)
762
+ return false unless item.is_a?(::Hash)
763
+
764
+ rule.when_attribute.all? do |name, expected|
765
+ actual = Lutaml::Model::Utils.fetch_str_or_sym(item, name.to_s)
766
+ !actual.nil? && actual.to_s == expected.to_s
767
+ end
768
+ end
769
+
770
+ # select/reject over the occurrence shape: an Array filters per
771
+ # item; a single occurrence is kept or dropped as a whole; nil
772
+ # passes through. A dropped occurrence existed on the wire, so a
773
+ # collection attribute reads it as [] rather than absent. A
774
+ # non-hash item satisfies no discriminator, so plain rules keep it
775
+ # and discriminator rules drop it.
776
+ def kv_partition_value(value, attr = nil, &block)
777
+ case value
778
+ when ::Array
779
+ value.select(&block)
780
+ when nil
781
+ nil
782
+ else
783
+ if yield(value)
784
+ value
785
+ else
786
+ attr&.collection? ? [] : nil
787
+ end
788
+ end
789
+ end
790
+
791
+ # lutaml-model#88: fail closed for `unmatched: :raise` — an item
792
+ # no rule on the key claims is exactly the data the default
793
+ # policy silently drops.
794
+ def check_unclaimed_kv_items!(value, rule, entry)
795
+ items = value.is_a?(::Array) ? value : [value]
796
+ tested = entry[:discriminators].flat_map { |s| s.when_attribute.keys }
797
+ .uniq.map(&:to_s)
798
+ items.each do |item|
799
+ next if entry[:discriminators].any? { |s| kv_item_matches?(item, s) }
800
+
801
+ values = tested.filter_map do |name|
802
+ v = item.is_a?(::Hash) &&
803
+ Lutaml::Model::Utils.fetch_str_or_sym(item, name)
804
+ "#{name}=#{v.inspect}" if v
805
+ end
806
+ raise ::Lutaml::Model::UnknownDiscriminatorError,
807
+ "Item at <#{kv_partition_key(rule)}> (#{values.join(', ')}) " \
808
+ "is claimed by no rule: it matches no when_attribute " \
809
+ "discriminator and no plain rule shares the key. Cover the " \
810
+ "value, add a plain rule, or opt out with unmatched: :drop"
811
+ end
812
+ nil
813
+ end
814
+
815
+ # Serialize a partitioned key as one wire value: every rule on the
816
+ # key contributes its items in declaration order, each stamped with
817
+ # its rule's discriminator pairs (unless the item already carries
818
+ # the key — the value's own mapping wins).
819
+ def process_partition_group!(instance, group, hash, format, options)
820
+ wire = rule_from_name(group[:rules].first)
821
+ items = []
822
+ present = false
823
+ group[:rules].each do |rule|
824
+ next unless valid_mapping?(rule, options)
825
+
826
+ scratch = {}
827
+ process_mapping_for_instance(instance, scratch, format, rule, options)
828
+ value = scratch[rule_from_name(rule)]
829
+ next if value.nil?
830
+
831
+ present = true
832
+ Array(value).each do |item|
833
+ items << kv_stamp_discriminator(item, rule)
834
+ end
835
+ end
836
+ return unless present
837
+
838
+ hash[wire] = items
839
+ end
840
+
841
+ def kv_stamp_discriminator(item, rule)
842
+ return item unless item.is_a?(::Hash)
843
+
844
+ missing = {}
845
+ rule.when_attribute.each do |name, expected|
846
+ unless Lutaml::Model::Utils.string_or_symbol_key?(item, name)
847
+ missing[name.to_s] = expected.to_s
848
+ end
849
+ end
850
+ missing.empty? ? item : item.merge(missing)
851
+ end
852
+
853
+ def process_mapping_rule(doc, instance, format, rule, options = {},
854
+ partition = nil)
855
+ plans = walk_plans_for(format)
856
+ plan = plans[rule] ||= build_walk_plan(format, rule)
857
+ kind = plan.kind
858
+ return if kind == :skip
859
+
860
+ raise "Attribute '#{rule.to}' not found in #{self}" unless plan.valid
861
+
862
+ attr = plan.attr
863
+
864
+ # lutaml-model#88: discriminator rules (and plain rules on a
865
+ # partitioned key) must filter the raw value, so they keep the
866
+ # interpretive path.
867
+ partitioned = partition && kv_partition_group(rule, partition)
868
+ if partitioned.nil? && kind == :scalar &&
869
+ (value = kv_fast_extract(doc, plan))
870
+ rule.deserialize(instance, kv_fast_cast(value, plan, instance),
871
+ attributes, self, options[:context], pre_cast: true)
872
+ return
873
+ end
874
+
875
+ value = rule_value_extractor_class.call(rule, doc, format, attr,
876
+ lutaml_register, options, instance)
877
+ if partitioned && !Lutaml::Model::Utils.uninitialized?(value)
878
+ value = apply_kv_when_attribute(value, rule, partitioned, attr)
879
+ end
880
+ value = apply_value_map(value, rule.value_map(:from, options), attr)
881
+
882
+ # An empty value ("", [], {}) is a present value per the
883
+ # missing-values semantics and must reach the custom method;
884
+ # only nil (non-existent) skips it (lutaml-model#746).
885
+ if (kind == :custom) && value.nil?
886
+ return
887
+ end
888
+
889
+ if kind == :custom
890
+ return rule.deserialize(instance, value, attributes, model_class,
891
+ options[:context])
892
+ end
893
+
894
+ value = rule.transform_value(attr, value, :from, format)
895
+ # Hash/child-mapping rules translate a hash document; an absent
896
+ # or explicit-null key has nothing to translate — the attribute
897
+ # keeps its uninitialized/default state (a nil here previously
898
+ # crashed translate_mappings).
899
+ return if value.nil? && kind == :hash_map
900
+
901
+ child_plan = plan.child_map
902
+ value = if child_plan
903
+ translate_child_map_compiled(value, child_plan, attr,
904
+ format, instance)
905
+ else
906
+ translate_mappings(value, rule.hash_mappings, attr, format,
907
+ instance)
908
+ end
909
+ unless kind == :hash_map
910
+ value = cast_value(value, attr, format, rule,
911
+ instance)
912
+ end
913
+
914
+ # Range errors stay eager here. The over-count error only fires when the
915
+ # attribute is not a collection, so this guard defers exactly that case
916
+ # to `.validate` while leaving declared ranges checked at parse. A mapped
917
+ # PORO has no `.validate` to defer into, so it keeps the eager check.
918
+ # singular_tolerance: :first on the KV lane (#971): collapse an
919
+ # over-ingested collection before the writer stores it whole.
920
+ value = value.first if attr.tolerates_singular_overflow?(value)
921
+
922
+ if attr.collection? || !instance.is_a?(Lutaml::Model::Serialize)
923
+ attr.valid_collection!(value, context)
924
+ end
925
+ # No pre_cast here: the interpretive attr.cast is not the full
926
+ # cast chain — whole-value Type policies (e.g. a custom
927
+ # Type::Value that receives the whole hash) are shaped by the
928
+ # setter's cast_value, which must still run.
929
+ rule.deserialize(instance, value, attributes, self,
930
+ options[:context])
931
+ end
932
+
933
+ # Compiled rule plans (TODO.perf/07): for plain scalar rules the
934
+ # per-value interpretation (extraction dispatch, type resolution,
935
+ # per-element probes, validation inside casts) collapses to a
936
+ # precomputed wire name, target class, and identity-guard cast.
937
+ # Guard + cached target — an inline cache per rule. Complex rules
938
+ # (custom methods, transforms, value maps, delegates, hash mappings,
939
+ # unions, polymorphism) return nil and keep the interpretive path.
940
+ WalkPlan = ::Struct.new(:kind, :attr, :valid, :wire, :klass,
941
+ :collection, :child_map)
942
+
943
+ # Compiled child-map translation (#986b): the per-node registry
944
+ # lookups (attribute type, child mapping rules, per-attribute wire
945
+ # names, path string casts) collapse to per-rule constants. nil
946
+ # child_map keeps the interpretive translate path (including its
947
+ # declaration-error timing).
948
+ ChildMapPlan = ::Struct.new(:child_mappings, :wire_names, :paths,
949
+ :keys_only, :child_rules, :attr_type)
950
+
951
+ # Memoized (per transform) wire name for plain rules — the from
952
+ # spelling never changes after definition.
953
+ KvSerializePlan = ::Struct.new(:wire)
954
+
955
+ def build_child_map_plan(format, rule, attr)
956
+ child_mappings = rule.hash_mappings
957
+ return nil unless child_mappings.is_a?(::Hash)
958
+
959
+ attr_type = attr.type(lutaml_register)
960
+ return nil unless attr_type.is_a?(Class) &&
961
+ attr_type.include?(Lutaml::Model::Serialize)
962
+
963
+ child_rules = attr_type.mappings_for(format, lutaml_register)
964
+ wire_names = {}
965
+ paths = {}
966
+ child_mappings.each do |attr_name, path|
967
+ attr_rule = child_rules.find_by_to!(attr_name)
968
+ wire_names[attr_name] = attr_rule.from.to_s
969
+ paths[attr_name] = compile_child_map_path(path)
970
+ end
971
+ ChildMapPlan.new(child_mappings, wire_names, paths,
972
+ child_mappings.values == [:key], child_rules,
973
+ attr_type)
974
+ rescue Lutaml::Model::NoMappingFoundError
975
+ nil
976
+ end
977
+
978
+ def compile_child_map_path(path)
979
+ case path
980
+ when :key then :key
981
+ when :value then :value
982
+ else Array(path).map(&:to_s).freeze
983
+ end
984
+ end
985
+
986
+ # Compiled translate_mappings (#986b). Same shape as the
987
+ # interpretive pair: keys_only is decided once per rule VALUE (the
988
+ # original tests the whole document hash, not each child).
989
+ def translate_child_map_compiled(value, child_plan, attr, format,
990
+ instance)
991
+ child_options = {
992
+ mappings: child_plan.child_rules,
993
+ lutaml_parent: instance,
994
+ lutaml_root: instance.lutaml_root || instance,
995
+ }
996
+ keys_only = child_plan.keys_only && value.values.all?(::Hash)
997
+ wire_names = child_plan.wire_names
998
+ paths = child_plan.paths
999
+ child_mappings = child_plan.child_mappings
1000
+
1001
+ value.map do |key, child_value|
1002
+ child_hash = {}
1003
+ child_mappings.each_key do |attr_name|
1004
+ child_hash[wire_names[attr_name]] =
1005
+ extract_compiled_child_value(paths[attr_name], key, child_value)
1006
+ end
1007
+ child_hash.merge!(child_value) if keys_only
1008
+ map_child_data(child_hash, attr, format, instance, child_plan,
1009
+ child_options)
1010
+ end
1011
+ end
1012
+
1013
+ def extract_compiled_child_value(compiled_path, key, value)
1014
+ case compiled_path
1015
+ when :key then key
1016
+ when :value then value
1017
+ else value.dig(*compiled_path)
1018
+ end
1019
+ end
1020
+
1021
+ def kv_serialize_plan(rule, attr, _instance)
1022
+ return nil if rule.delegate || rule.raw_mapping? || rule.root_mapping? ||
1023
+ rule.hash_mappings || rule.child_mappings ||
1024
+ rule.has_custom_method_for_serialization? ||
1025
+ rule.when_attribute? || rule.multiple_mappings? ||
1026
+ polymorphic_rule?(rule) ||
1027
+ (rule.transform.is_a?(Hash) && !rule.transform.empty?) ||
1028
+ rule.transform.is_a?(Class) || attr.nil? || attr.derived? ||
1029
+ attr.union? || attr.polymorphic? || attr.custom_collection? ||
1030
+ attr.transform ||
1031
+ rule.value_map(:to) != Lutaml::Model::Serialize::DEFAULT_VALUE_MAP
1032
+
1033
+ @kv_serialize_plans ||= {}.compare_by_identity
1034
+ @kv_serialize_plans[rule] ||= KvSerializePlan.new(rule_from_name(rule))
1035
+ end
1036
+
1037
+ def walk_plans_for(format)
1038
+ generation = Lutaml::Model::GlobalContext.context_generation
1039
+ if @lutaml_walk_plans.nil? || @lutaml_walk_generation != generation ||
1040
+ @lutaml_walk_format != format
1041
+ key = [model_class, lutaml_register, format, generation,
1042
+ @lutaml_mapping_override]
1043
+ @lutaml_walk_plans =
1044
+ (KV_WALK_PLANS[key] ||= build_walk_plans(format))
1045
+ @lutaml_walk_generation = generation
1046
+ @lutaml_walk_format = format
1047
+ end
1048
+ @lutaml_walk_plans
1049
+ end
1050
+
1051
+ def build_walk_plans(format)
1052
+ plans = {}.compare_by_identity
1053
+ mappings_for(format).mappings(lutaml_register).each do |rule|
1054
+ plans[rule] = build_walk_plan(format, rule)
1055
+ end
1056
+ plans
1057
+ end
1058
+
1059
+ # The per-rule dispatch compile. Kind precedence mirrors the
1060
+ # interpretive method exactly: skip (derived) > invalid >
1061
+ # custom (deserialization custom method) > hash_map
1062
+ # (hash_mappings truthy — translate, never cast) > scalar (the
1063
+ # fast-extract eligibility) > interpretive.
1064
+ def build_walk_plan(format, rule, _attrs = nil)
1065
+ attr = attribute_for_rule(rule)
1066
+ return WalkPlan.new(:skip, nil, false, nil, nil, false) if attr&.derived?
1067
+
1068
+ valid = valid_rule?(rule, attr)
1069
+ kind =
1070
+ if rule.has_custom_method_for_deserialization?
1071
+ :custom
1072
+ elsif rule.hash_mappings
1073
+ :hash_map
1074
+ else
1075
+ plan = build_kv_rule_plan(format, rule, attr)
1076
+ plan ? :scalar : :interpretive
1077
+ end
1078
+
1079
+ if kind == :hash_map && attr
1080
+ child = build_child_map_plan(format, rule, attr)
1081
+ return WalkPlan.new(:hash_map, attr, valid, nil, nil, false, child)
1082
+ end
1083
+
1084
+ plan || WalkPlan.new(kind, attr, valid, nil, nil, false)
1085
+ end
1086
+
1087
+ # `rule.polymorphic` defaults to an empty Hash, which is truthy —
1088
+ # presence is emptiness-based, mirroring MappingRule#polymorphic_mapping?.
1089
+ def polymorphic_rule?(rule)
1090
+ poly = rule.polymorphic
1091
+ poly.respond_to?(:empty?) ? !poly.empty? : !!poly
1092
+ end
1093
+
1094
+ def build_kv_rule_plan(_format, rule, attr)
1095
+ return nil if rule.raw_mapping? ||
1096
+ rule.has_custom_method_for_deserialization? ||
1097
+ rule.hash_mappings || rule.multiple_mappings? ||
1098
+ polymorphic_rule?(rule) || rule.delegate ||
1099
+ (rule.transform.is_a?(Hash) && !rule.transform.empty?) ||
1100
+ rule.transform.is_a?(Class) ||
1101
+ attr.derived? ||
1102
+ attr.union? || attr.polymorphic? ||
1103
+ attr.custom_collection?
1104
+
1105
+ type = attr.type(lutaml_register)
1106
+ return nil unless type.is_a?(Class) &&
1107
+ type < ::Lutaml::Model::Type::Value &&
1108
+ !attr.value_policy.whole_value?(type) &&
1109
+ !Lutaml::Model::Attribute.custom_from_probe?(type)
1110
+
1111
+ WalkPlan.new(:scalar, attr, true, rule.name.to_s, type,
1112
+ attr.collection?)
1113
+ end
1114
+
1115
+ # Extraction fast path: plain hash fetch for a present, non-blank
1116
+ # value. nil/blank values keep the interpretive path — their
1117
+ # value-map/missing-value semantics must not be duplicated here.
1118
+ def kv_fast_extract(doc, plan)
1119
+ return nil unless doc.is_a?(::Hash)
1120
+
1121
+ v = doc[plan.wire]
1122
+ return nil if v.nil?
1123
+ return nil if v.is_a?(::String) && v.empty?
1124
+ return nil if v.is_a?(::Array) && (v.empty? || !plan.collection)
1125
+ # Structured values on scalar plans keep the interpretive path —
1126
+ # its collection guidance error and cast semantics own them.
1127
+ return nil if v.is_a?(::Hash)
1128
+
1129
+ v
1130
+ end
1131
+
1132
+ # Cast fast path: identity when the value already has the target
1133
+ # class (the overwhelming case for engine-typed scalars), the type's
1134
+ # cast otherwise. Collections cast per element.
1135
+ def kv_fast_cast(value, plan, _instance)
1136
+ if plan.collection
1137
+ unless value.is_a?(::Array)
1138
+ return value.is_a?(plan.klass) ? value : plan.klass.cast(value)
1139
+ end
1140
+
1141
+ klass = plan.klass
1142
+ value.map { |e| e.is_a?(klass) ? e : klass.cast(e) }
1143
+ else
1144
+ value.is_a?(plan.klass) ? value : plan.klass.cast(value)
1145
+ end
1146
+ end
1147
+
1148
+ def cast_value(value, attr, format, rule, instance)
1149
+ cast_options = rule.polymorphic ? { polymorphic: rule.polymorphic } : {}
1150
+ cast_options[:lutaml_parent] = instance if instance
1151
+ if instance
1152
+ cast_options[:lutaml_root] =
1153
+ (instance.lutaml_root || instance)
1154
+ end
1155
+ attr.cast(value, format, lutaml_register, cast_options)
1156
+ end
1157
+
1158
+ def translate_mappings(hash, child_mappings, attr, format, instance)
1159
+ return hash unless child_mappings
1160
+
1161
+ hash.map do |key, value|
1162
+ process_child_mapping(key, value, child_mappings, attr, format, hash,
1163
+ instance)
1164
+ end
1165
+ end
1166
+
1167
+ def process_child_mapping(key, value, child_mappings, attr, format, hash,
1168
+ instance)
1169
+ child_hash = build_child_hash(key, value, child_mappings, attr, format)
1170
+
1171
+ if only_keys_mapped?(child_mappings, hash)
1172
+ child_hash.merge!(value)
1173
+ end
1174
+
1175
+ map_child_data(child_hash, attr, format, instance)
1176
+ end
1177
+
1178
+ def build_child_hash(key, value, child_mappings, attr, format)
1179
+ attr_type = attr.type(lutaml_register)
1180
+ child_mappings.to_h do |attr_name, path|
1181
+ attr_value = extract_attr_value(path, key, value)
1182
+ attr_rule = attr_type.mappings_for(format,
1183
+ lutaml_register).find_by_to!(attr_name)
1184
+ [attr_rule.from.to_s, attr_value]
1185
+ end
1186
+ end
1187
+
1188
+ def extract_attr_value(path, key, value)
1189
+ case path
1190
+ when :key then key
1191
+ when :value then value
1192
+ else
1193
+ path = Array(path)
1194
+ value.dig(*path.map(&:to_s))
1195
+ end
1196
+ end
1197
+
1198
+ def only_keys_mapped?(child_mappings, hash)
1199
+ child_mappings.values == [:key] && hash.values.all?(::Hash)
1200
+ end
1201
+
1202
+ def map_child_data(child_hash, attr, format, instance,
1203
+ child_plan = nil, child_options = nil)
1204
+ if child_plan
1205
+ self.class.data_to_model(child_plan.attr_type, child_hash, format,
1206
+ child_options)
1207
+ else
1208
+ attr_type = attr.type(lutaml_register)
1209
+ options = {
1210
+ mappings: attr_type.mappings_for(format, lutaml_register),
1211
+ lutaml_parent: instance,
1212
+ lutaml_root: instance.lutaml_root || instance,
1213
+ }
1214
+ self.class.data_to_model(attr_type, child_hash, format, options)
1215
+ end
1216
+ end
1217
+
1218
+ def rule_value_extractor_class
1219
+ Lutaml::Model::RuleValueExtractor
1220
+ end
1221
+ end
1222
+ end
1223
+ end