lutaml 0.11.6 → 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,1276 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Lutaml
4
+ module KeyValue
5
+ # KeyValue-specific transformation implementation.
6
+ #
7
+ # Transforms model instances into KeyValueElement trees without
8
+ # serialization concerns. This provides the same architectural
9
+ # pattern as Xml::Transformation but for key-value formats
10
+ # (JSON, YAML, TOML).
11
+ #
12
+ # Architecture:
13
+ # - Content Layer: KeyValueElement defines WHAT to serialize
14
+ # - Presentation Layer: Adapters define HOW to serialize
15
+ #
16
+ # This is a critical step toward symmetric OOP architecture
17
+ # across all serialization formats.
18
+ # Coerces values the model layer accepted into a rule's declared
19
+ # nested type (lutaml-model#1089): constructors and writers accept
20
+ # raw hashes, sibling Serializable instances, and content scalars,
21
+ # but the KeyValue serializer demanded exact declared-class
22
+ # instances — accept-then-explode mid-render. Hashes construct
23
+ # directly; Serializable siblings round-trip through the framework
24
+ # hash; scalars wrap onto the declared type's content attribute
25
+ # when its XML mapping declares one (`map_content to: :x` — the
26
+ # same semantics the XML lane applies to text). Genuinely
27
+ # un-coercible values pass through unchanged so the caller's
28
+ # validation raises with its own message.
29
+ module NestedValueCoercion
30
+ @content_attributes = {}.compare_by_identity
31
+
32
+ # The attribute a declared type's XML mapping designates as its
33
+ # textual content. Class-level memo: the answer is a static
34
+ # per-type mapping fact. Keyed by type only; register-specific
35
+ # content mappings are not a supported combination.
36
+ def self.content_attribute_for(type)
37
+ @content_attributes[type] ||= begin
38
+ mapping = type.mappings_for(:xml)
39
+ mapping&.content_mapping&.to
40
+ end
41
+ end
42
+
43
+ def self.coerce(value, declared_class)
44
+ if value.is_a?(::Hash)
45
+ declared_class.new(value)
46
+ elsif value.is_a?(Lutaml::Model::Serialize)
47
+ declared_class.new(value.to_hash)
48
+ elsif (content_key = content_attribute_for(declared_class))
49
+ declared_class.new(content_key => value)
50
+ else
51
+ value
52
+ end
53
+ end
54
+ end
55
+
56
+ class Transformation < Lutaml::Model::Transformation
57
+ # Builtin Value types whose cast of an already-native value is the
58
+ # identity — used by the serialize_value fast path.
59
+ NATIVE_VALUE_CLASS = {
60
+ ::Lutaml::Model::Type::String => ::String,
61
+ ::Lutaml::Model::Type::Integer => ::Integer,
62
+ ::Lutaml::Model::Type::Float => ::Float,
63
+ ::Lutaml::Model::Type::Date => ::Date,
64
+ ::Lutaml::Model::Type::Time => ::Time,
65
+ ::Lutaml::Model::Type::DateTime => ::DateTime,
66
+ ::Lutaml::Model::Type::Symbol => ::Symbol,
67
+ }.freeze
68
+
69
+ include Lutaml::Model::RenderPolicy
70
+
71
+ autoload :RuleCompiler, "#{__dir__}/transformation/rule_compiler"
72
+ autoload :ValueSerializer, "#{__dir__}/transformation/value_serializer"
73
+ autoload :CollectionSerializer,
74
+ "#{__dir__}/transformation/collection_serializer"
75
+
76
+ # Initialize serializers before calling super
77
+ # This must happen before super calls freeze
78
+ #
79
+ # @param model_class [Class] The model class to transform
80
+ # @param mapping_dsl [Mapping] The mapping DSL to compile
81
+ # @param format [Symbol] The format (:json, :yaml, :toml)
82
+ # @param register [Register, nil] The register for type resolution
83
+ def initialize(model_class, mapping_dsl, format, register)
84
+ # Extract register_id before super
85
+ register_id = extract_register_id(register)
86
+ # #985: the catch-all target (collected unknown keys) — merged
87
+ # after the compiled rules on serialize; mapped keys win. The
88
+ # DSL object is a KeyValue::Mapping by contract, and the target
89
+ # must be a declared attribute: a typo fails here, at compile
90
+ # time, not as a silent no-op on the wire.
91
+ @unmapped_attribute = mapping_dsl.unmapped_attribute
92
+ if @unmapped_attribute &&
93
+ !model_class.attributes(register_id).key?(@unmapped_attribute)
94
+ raise ArgumentError,
95
+ "map_unmapped target :#{@unmapped_attribute} is not a " \
96
+ "declared attribute of #{model_class}"
97
+ end
98
+ transformation_factory = ->(type_class) {
99
+ build_child_transformation(type_class)
100
+ }
101
+
102
+ # Set up serializers before calling super
103
+ # The super will call compile_rules and freeze
104
+ # Pre-declared: the transformation is frozen after compile, and
105
+ # the type-transformation memo mutates this hash in place.
106
+ @lutaml_type_transformations = {}
107
+ @rule_compiler = RuleCompiler.new(
108
+ model_class: model_class,
109
+ register_id: register_id,
110
+ format: format,
111
+ transformation_factory: transformation_factory,
112
+ )
113
+
114
+ @value_serializer = ValueSerializer.new(
115
+ format: format,
116
+ register_id: register_id,
117
+ model_class: model_class,
118
+ transformation_factory: transformation_factory,
119
+ )
120
+
121
+ @collection_serializer = CollectionSerializer.new(
122
+ format: format,
123
+ register_id: register_id,
124
+ value_serializer: @value_serializer,
125
+ transformation_factory: transformation_factory,
126
+ )
127
+
128
+ super
129
+ end
130
+
131
+ # Extract register_id from register parameter
132
+ #
133
+ # @param register [Register, Symbol, nil] The register
134
+ # @return [Symbol, nil] The register ID
135
+ def extract_register_id(register)
136
+ case register
137
+ when Lutaml::Model::Register
138
+ register.id
139
+ when Symbol
140
+ register
141
+ else
142
+ Lutaml::Model::Config.default_register
143
+ end
144
+ end
145
+
146
+ # Build child transformation for nested model
147
+ #
148
+ # @param type_class [Class] The nested model class
149
+ # @param format [Symbol] The format
150
+ # @param register [Register, nil] The register
151
+ # @return [Transformation, nil] Child transformation or nil
152
+ def build_child_transformation(type_class, format = self.format,
153
+ register = self.register)
154
+ return nil unless type_class.is_a?(Class) &&
155
+ type_class.include?(Lutaml::Model::Serialize)
156
+
157
+ # Prevent infinite recursion for self-referential models
158
+ compilation_stack = Thread.current[:lutaml_compilation_stack] ||= []
159
+ return nil if compilation_stack.include?(type_class)
160
+
161
+ compilation_stack.push(type_class)
162
+ begin
163
+ # Get the mapping for the current format
164
+ mapping = type_class.mappings_for(format,
165
+ extract_register_id(register))
166
+
167
+ # Create a new Transformation instance with the mapping
168
+ self.class.new(type_class, mapping, format, register)
169
+ ensure
170
+ compilation_stack.pop
171
+ end
172
+ end
173
+
174
+ # lutaml-model#88: rules sharing a wire key through when_attribute
175
+ # must serialize as ONE value — group them here, before freeze.
176
+ # Rules with custom `to` methods or delegates keep their own path;
177
+ # a key mixing them with discriminator rules is not a partition.
178
+ def after_compile
179
+ partitioned_names = nil
180
+ compiled_rules.each do |rule|
181
+ pairs = rule.option(:when_attribute)
182
+ next if pairs.nil? || pairs.empty?
183
+
184
+ (partitioned_names ||= {})[rule.serialized_name] = true
185
+ end
186
+ return unless partitioned_names
187
+
188
+ groups = {}
189
+ by_rule = {}.compare_by_identity
190
+ compiled_rules.each do |rule|
191
+ name = rule.serialized_name
192
+ next unless partitioned_names[name]
193
+ next if (rule.custom_methods || {}).key?(:to) || rule.option(:delegate)
194
+
195
+ entry = (groups[name] ||= [])
196
+ entry << rule
197
+ by_rule[rule] = entry
198
+ end
199
+ groups.each_value(&:freeze)
200
+
201
+ @partition_groups = groups.freeze
202
+ @partitioned_rules = by_rule
203
+ end
204
+
205
+ private
206
+
207
+ # Get the register ID, handling both Symbol and Register objects
208
+ # This normalizes the register to an ID for backward compatibility
209
+ #
210
+ # @return [Symbol, nil] The register ID
211
+ def register_id
212
+ return @register if @register.is_a?(Symbol)
213
+
214
+ @register_id
215
+ end
216
+
217
+ # Compile key-value mapping DSL into pre-compiled rules
218
+ #
219
+ # @param mapping_dsl [Mapping::KeyValueMapping] The mapping to compile
220
+ # @return [Array<CompiledRule>] Array of compiled transformation rules
221
+ def compile_rules(mapping_dsl)
222
+ rule_compiler.compile(mapping_dsl)
223
+ end
224
+
225
+ # Get the rule compiler instance
226
+ #
227
+ # @return [RuleCompiler] The rule compiler
228
+ def rule_compiler
229
+ @rule_compiler
230
+ end
231
+
232
+ # Get the value serializer instance
233
+ #
234
+ # @return [ValueSerializer] The value serializer
235
+ def value_serializer
236
+ @value_serializer
237
+ end
238
+
239
+ # Get the collection serializer instance
240
+ #
241
+ # @return [CollectionSerializer] The collection serializer
242
+ def collection_serializer
243
+ @collection_serializer
244
+ end
245
+
246
+ # Check if a mapping rule should be applied based on only/except options
247
+ #
248
+ # @param rule [CompiledRule] The rule to check
249
+ # @param options [Hash] Transformation options (may contain :only, :except)
250
+ # @return [Boolean] true if the rule should be applied
251
+ def valid_mapping?(rule, options)
252
+ rule_compiler.valid_mapping?(rule, options)
253
+ end
254
+
255
+ public
256
+
257
+ # Transform a model instance into KeyValueElement tree
258
+ #
259
+ # @param model_instance [Object] The model instance to transform
260
+ # @param options [Hash] Transformation options (supports :only, :except for filtering)
261
+ # @return [Lutaml::KeyValue::DataModel::Element] The root element
262
+ def transform(model_instance, options = {})
263
+ # For key-value formats, we typically don't have a named root
264
+ # Instead, we create an anonymous root that holds all attributes
265
+ # Hash-direct emission (TODO.perf 19): the output hash is built
266
+ # directly; the intermediate Element tree and its flatten are gone.
267
+ root = {}
268
+
269
+ # Apply each compiled rule (with filtering support). A
270
+ # when_attribute partition applies once for its whole key.
271
+ handled_groups = nil
272
+ compiled_rules.each do |rule|
273
+ # Check if this rule should be applied based on only/except options
274
+ next unless valid_mapping?(rule, options)
275
+
276
+ if @partitioned_rules && (group = @partitioned_rules[rule])
277
+ next if handled_groups&.include?(group)
278
+
279
+ (handled_groups ||= []) << group
280
+ apply_partition_group(root, group, model_instance, options)
281
+ else
282
+ apply_rule(root, rule, model_instance, options)
283
+ end
284
+ end
285
+
286
+ if @unmapped_attribute
287
+ extras = model_instance.public_send(@unmapped_attribute)
288
+ extras.each { |key, value| root[key] ||= value } if extras.is_a?(::Hash)
289
+ end
290
+
291
+ if ENV["DEBUG_KEYED_COLLECTION"]
292
+ puts "=== TRANSFORM COMPLETE ==="
293
+ puts "root: #{root.inspect}"
294
+ end
295
+
296
+ root
297
+ end
298
+
299
+ private
300
+
301
+ # The rule's value on the instance, initializing an absent
302
+ # delegate target like apply_rule does.
303
+ def extract_rule_value(rule, model_instance)
304
+ delegate = rule.option(:delegate)
305
+ unless delegate
306
+ return model_instance.public_send(rule.attribute_name)
307
+ end
308
+
309
+ delegated_object = model_instance.public_send(delegate)
310
+ if delegated_object.nil? ||
311
+ Lutaml::Model::Utils.uninitialized?(delegated_object)
312
+ delegate_attr = model_class.attributes(register_id)&.[](delegate)
313
+ if delegate_attr
314
+ delegated_object = delegate_attr.type(register_id).new
315
+ model_instance.public_send(:"#{delegate}=", delegated_object)
316
+ end
317
+ end
318
+ delegated_object&.public_send(rule.attribute_name)
319
+ end
320
+
321
+ # Serialize one when_attribute partition: every rule on the key
322
+ # contributes its items in declaration order, each stamped with
323
+ # its rule's discriminator pairs (unless the item's own mapping
324
+ # already wrote the key). The wire value is an array whenever any
325
+ # rule had a present value.
326
+ def apply_partition_group(parent, group, model_instance, options)
327
+ items = []
328
+ present = false
329
+ group.each do |rule|
330
+ next unless valid_mapping?(rule, options)
331
+
332
+ value = extract_rule_value(rule, model_instance)
333
+ next if should_skip_value?(value, rule, model_instance,
334
+ rule.option(:delegate))
335
+
336
+ value = rule.transform_value(value, :export) if rule.value_transformer
337
+
338
+ present = true
339
+ Array(value).each do |item|
340
+ child = create_value_for_item(rule, item, options)
341
+ next if child.nil?
342
+
343
+ items << stamp_discriminator(child, rule)
344
+ end
345
+ end
346
+ return unless present
347
+
348
+ # Items are stamped hashes or primitives: the tree's
349
+ # children_to_array semantics, expressed directly.
350
+ parent[group.first.serialized_name] = items
351
+ end
352
+
353
+ def stamp_discriminator(item, rule)
354
+ pairs = rule.option(:when_attribute)
355
+ return item if pairs.nil? || pairs.empty? || !item.is_a?(::Hash)
356
+
357
+ missing = {}
358
+ pairs.each do |name, expected|
359
+ unless Lutaml::Model::Utils.string_or_symbol_key?(item, name)
360
+ missing[name.to_s] = expected.to_s
361
+ end
362
+ end
363
+ missing.empty? ? item : item.merge(missing)
364
+ end
365
+
366
+ # Apply a single transformation rule
367
+ #
368
+ # @param parent [Lutaml::KeyValue::DataModel::Element] Parent element
369
+ # @param rule [CompiledRule] The rule to apply
370
+ # @param model_instance [Object] The model instance
371
+ # @param options [Hash] Transformation options
372
+ def apply_rule(parent, rule, model_instance, options)
373
+ # DEBUG for keyed collections
374
+ if ENV["DEBUG_KEYED_COLLECTION"]
375
+ puts "apply_rule: #{rule.serialized_name}, collection?: #{rule.collection?}"
376
+ if rule.collection?
377
+ puts " collection_info: #{rule.collection_info.inspect}"
378
+ puts " child_mappings: #{rule.collection_info && rule.collection_info[:child_mappings].inspect}"
379
+ end
380
+ end
381
+
382
+ # Handle custom serialization methods (e.g., with: { to: ... })
383
+ if rule.has_custom_methods? && rule.custom_methods[:to]
384
+ to_method = rule.custom_methods[:to]
385
+ # Custom methods receive an Element "doc" and populate it
386
+ # (public contract, TODO.perf 19 keeps it): only the doc's
387
+ # payload — the merged children or the direct value hash —
388
+ # is merged into the output.
389
+ doc = Lutaml::KeyValue::DataModel::Element.new(rule.serialized_name)
390
+ # Custom methods may write children, or doc.value[key]=, or
391
+ # nothing at all (pubid 2.0 regression: an empty scratch
392
+ # flattened to {key => nil} and crashed the merge). Seed the
393
+ # value hash and merge only hash-shaped results.
394
+ doc.value = {}
395
+ # lutaml-model#550: custom methods may declare a third context
396
+ # parameter to receive the options passed to `to_*`.
397
+ if Lutaml::Model::MappingRule.custom_method_arity(model_instance.class, to_method).to_i >= 3
398
+ model_instance.public_send(to_method, model_instance,
399
+ doc, options[:context])
400
+ else
401
+ model_instance.public_send(to_method, model_instance, doc)
402
+ end
403
+ # The 0.8.68 contract: only the method's doc mutations count —
404
+ # its return value is ignored. (A mutation-style handler whose
405
+ # last statement is an assignment returns the assigned inner
406
+ # value; honoring it merged child content at the wrong level —
407
+ # lutaml-model#892.) A doc whose payload is not a hash — nil
408
+ # (untouched), a scalar, or an array of primitives — serializes
409
+ # as nothing, matching the pre-0.8.74 behavior.
410
+ merged = doc.payload
411
+ parent.update(merged) if merged.is_a?(::Hash)
412
+ return
413
+ end
414
+
415
+ # Handle delegation - extract value from delegated object
416
+ delegate = rule.option(:delegate)
417
+ if delegate
418
+ # Get the delegated object
419
+ delegated_object = model_instance.public_send(delegate)
420
+
421
+ # Initialize delegated object if nil/uninitialized (like legacy does)
422
+ if delegated_object.nil? || Lutaml::Model::Utils.uninitialized?(delegated_object)
423
+ # Get the delegate attribute from model to create a new instance
424
+ delegate_attr = model_class.attributes(register_id)&.[](delegate)
425
+ if delegate_attr
426
+ delegated_object = delegate_attr.type(register_id).new
427
+ model_instance.public_send(:"#{delegate}=", delegated_object)
428
+ end
429
+ end
430
+
431
+ # Extract value from delegated object
432
+ value = delegated_object&.public_send(rule.attribute_name)
433
+ else
434
+ # Get attribute value directly
435
+ value = model_instance.public_send(rule.attribute_name)
436
+ end
437
+
438
+ # Handle raw mapping (map_all directive)
439
+ # Raw mappings parse the stored content and merge it directly into the parent
440
+ if rule.option(:mapping_type) == :raw
441
+ return handle_raw_mapping(parent, value, options)
442
+ end
443
+
444
+ # Check if value should be skipped
445
+ skip_result = should_skip_value?(value, rule, model_instance,
446
+ delegate)
447
+
448
+ return if skip_result
449
+
450
+ # Apply export transformation if present
451
+ if rule.value_transformer
452
+ value = rule.transform_value(value, :export)
453
+ end
454
+
455
+ # Create element for this attribute
456
+ if rule.collection?
457
+ # For collections, apply value_map conversion with tracking flags
458
+ # so the collection serializer knows the original intent
459
+ converted_from_empty_to_nil = false
460
+ converted_from_nil_to_empty = false
461
+ value_map = rule.option(:value_map) || {}
462
+ to_map = value_map[:to] || {}
463
+
464
+ if value.nil?
465
+ to_nil = to_map[:nil]
466
+ if to_nil == :empty
467
+ converted_from_nil_to_empty = true
468
+ end
469
+ elsif Lutaml::Model::Utils.empty?(value)
470
+ to_empty = to_map[:empty] # nil → no conversion (default: omit)
471
+ if to_empty == :nil
472
+ value = nil
473
+ converted_from_empty_to_nil = true
474
+ end
475
+ end
476
+
477
+ collection_serializer.serialize(parent, value, rule, options,
478
+ converted_from_empty_to_nil: converted_from_empty_to_nil,
479
+ converted_from_nil_to_empty: converted_from_nil_to_empty)
480
+ else
481
+ # For non-collections, pass original value directly.
482
+ # create_value_element handles all value_map conversions with full context.
483
+ create_value_element(parent, rule, value, options)
484
+ end
485
+ end
486
+
487
+ # Check if value should be skipped based on render options
488
+ #
489
+ # Delegates to the shared RenderPolicy module for consistent
490
+ # behavior across XML and KeyValue formats.
491
+ #
492
+ # @param value [Object] The value to check
493
+ # @param rule [CompiledRule] The rule
494
+ # @param model_instance [Object] The model instance
495
+ # @param delegate [Symbol, nil] The delegate attribute name if present
496
+ # @return [Boolean] true if should skip
497
+ def should_skip_value?(value, rule, model_instance, delegate = nil)
498
+ if delegate
499
+ delegate_obj = model_instance.public_send(delegate)
500
+ should_skip_delegated_value?(value, rule, delegate_obj)
501
+ else
502
+ super(value, rule, model_instance)
503
+ end
504
+ end
505
+
506
+ # Create a collection element
507
+ #
508
+ # @param parent [Lutaml::KeyValue::DataModel::Element] Parent element
509
+ # @param rule [CompiledRule] The rule
510
+ # @param collection [Array] The collection value
511
+ # @param options [Hash] Options
512
+ # @param converted_from_empty_to_nil [Boolean] True if value was converted from empty to nil
513
+ # @param converted_from_nil_to_empty [Boolean] True if value should be converted from nil to empty
514
+ def create_collection_element(parent, rule, collection, options,
515
+ converted_from_empty_to_nil: false, converted_from_nil_to_empty: false)
516
+ # Handle nil collection - skip if nil unless should render
517
+ if collection.nil?
518
+ to_map = (rule.option(:value_map) || {})[:to] || {}
519
+ nil_mapping = to_map[:nil]
520
+ if nil_mapping == :empty || converted_from_nil_to_empty
521
+ parent[rule.serialized_name] = []
522
+ elsif nil_mapping == :nil || converted_from_empty_to_nil
523
+ parent[rule.serialized_name] = nil
524
+ else
525
+ # Skip nil collection
526
+ end
527
+ return
528
+ end
529
+
530
+ # Convert to array for consistent handling
531
+ items = Array(collection)
532
+
533
+ # Check if this has root_mappings - merge directly into parent
534
+ root_mappings = rule.option(:root_mappings)
535
+ if root_mappings
536
+ # For root_mappings, the collection items are keyed and merged directly into parent
537
+ # Find the attribute to use as key
538
+ key_attribute = root_mappings.key(:key)
539
+ # Find the attribute to use as value (optional - if not provided, serialize all attributes)
540
+ value_attribute = root_mappings.key(:value)
541
+
542
+ # Initialize parent's value as a hash if it's nil
543
+ parent.value ||= {} if parent.value.nil?
544
+
545
+ # Case 1: Both key and value attributes specified
546
+ if key_attribute && value_attribute
547
+ items.each do |item|
548
+ next if item.nil?
549
+
550
+ # Get the key value from the item
551
+ key_value = if item.is_a?(Lutaml::Model::Serialize) && item.class.attributes.key?(key_attribute)
552
+ item.public_send(key_attribute)
553
+ end
554
+ next if key_value.nil?
555
+
556
+ # Get the value from the item
557
+ attr_value = if item.is_a?(Lutaml::Model::Serialize) && item.class.attributes.key?(value_attribute)
558
+ item.public_send(value_attribute)
559
+ end
560
+ next if attr_value.nil? || Lutaml::Model::Utils.uninitialized?(attr_value)
561
+
562
+ # For the value, we need to transform it appropriately
563
+ # First, check if it's a single nested model
564
+ item_class = item.class
565
+ attr_def = item_class.attributes(register_id)&.[](value_attribute)
566
+
567
+ if attr_def && attr_value.is_a?(Lutaml::Model::Serialize)
568
+ # Single nested model - transform it to a hash
569
+ attr_type = attr_def.type(register_id)
570
+ if attr_type.is_a?(Class) && attr_type < Lutaml::Model::Serialize
571
+ # Get the mapping for the value's class
572
+ value_class_mapping = attr_value.class.mappings_for(format,
573
+ register_id)
574
+
575
+ # Build a transformation for the value's class
576
+ value_transformation = self.class.new(attr_value.class,
577
+ value_class_mapping, format, register)
578
+
579
+ # Transform the value to a KeyValueElement
580
+ value_root = value_transformation.transform(attr_value,
581
+ options)
582
+
583
+ # transform emits the output hash directly (TODO.perf 19)
584
+ parent[key_value.to_s] = value_root
585
+ next
586
+ end
587
+ end
588
+
589
+ # Check if it's a collection
590
+ if attr_value.is_a?(Array) || attr_value.is_a?(Lutaml::Model::Collection)
591
+ # Get the attribute definition for the value attribute from the item's class
592
+ item_class = item.class
593
+ attr_def = item_class.attributes(register_id)&.[](value_attribute)
594
+ next unless attr_def
595
+
596
+ # Get the type of items in the collection
597
+ item_type = attr_def.type(register_id)
598
+
599
+ # Get the child transformation for the collection item type
600
+ if item_type.is_a?(Class) && item_type < Lutaml::Model::Serialize
601
+ # Create a temporary parent KeyValueElement to hold the collection
602
+ temp_parent = {}
603
+
604
+ # Convert to array
605
+ coll_items = Array(attr_value)
606
+
607
+ # Get the mapping for the item's class
608
+ item_class_mapping = item_class.mappings_for(format,
609
+ register_id)
610
+
611
+ # Build a temporary transformation for the item's class
612
+ item_class_transformation = self.class.new(item_class,
613
+ item_class_mapping, format, register)
614
+
615
+ # Find the rule for the value_attribute in the item's class mapping
616
+ item_rule = item_class_transformation.compiled_rules.find do |r|
617
+ r.attribute_name == value_attribute
618
+ end
619
+
620
+ if item_rule&.collection_info && item_rule.collection_info[:child_mappings]
621
+ # Use the keyed collection handling
622
+ child_mappings = item_rule.collection_info[:child_mappings]
623
+ coll_key_attr = keyed_collection_key_attribute(child_mappings)
624
+
625
+ if coll_key_attr
626
+ # Create a keyed collection directly
627
+ create_keyed_collection_element(temp_parent, item_rule,
628
+ coll_items, coll_key_attr, child_mappings, options)
629
+ else
630
+ create_array_collection_element(temp_parent, item_rule,
631
+ coll_items, options)
632
+ end
633
+ elsif item_rule
634
+ # No child_mappings - serialize as array
635
+ create_array_collection_element(temp_parent, item_rule,
636
+ coll_items, options)
637
+ end
638
+
639
+ coll_value = temp_parent[value_attribute.to_s]
640
+
641
+ parent[key_value.to_s] = coll_value
642
+ next
643
+ end
644
+ end
645
+
646
+ # Fallback: just use the value directly
647
+ parent[key_value.to_s] = attr_value
648
+ end
649
+ # Case 2: Only key attribute specified - serialize all other attributes
650
+ elsif key_attribute
651
+ items.each do |item|
652
+ next if item.nil?
653
+
654
+ key_value = if item.is_a?(Lutaml::Model::Serialize) && item.class.attributes.key?(key_attribute)
655
+ item.public_send(key_attribute)
656
+ end
657
+ next if key_value.nil?
658
+
659
+ # Serialize all attributes except the key
660
+ item_hash = {}
661
+ item_class = item.class
662
+
663
+ # Get the mapping for the item's class to find serialized names
664
+ if item_class.is_a?(Class) && item_class.include?(Lutaml::Model::Serialize)
665
+ item_class_mapping = item_class.mappings_for(format,
666
+ register_id)
667
+
668
+ item_class.attributes(register_id).each do |attr_name, attr_def|
669
+ # Skip the key attribute since it's used as the hash key
670
+ next if attr_name == key_attribute
671
+
672
+ attr_value = item.public_send(attr_name)
673
+ next if attr_value.nil? || Lutaml::Model::Utils.uninitialized?(attr_value)
674
+
675
+ # Serialize the attribute value
676
+ serialized_value = serialize_collection_item_value(
677
+ attr_value, attr_def, options
678
+ )
679
+
680
+ # Determine the path for this attribute based on root_mappings
681
+ # root_mappings format: { attr_name => path_spec }
682
+ # where path_spec can be:
683
+ # - :key (used as hash key, already skipped above)
684
+ # - "string" (single key, use the string)
685
+ # - [:path, :to, :nested] (array of path segments)
686
+ path_spec = root_mappings[attr_name]
687
+
688
+ # Use the path_spec if present, otherwise use the serialized name from mapping
689
+ if path_spec
690
+ if path_spec.is_a?(Array)
691
+ # Build nested structure: [:path, :to, :nested] -> item_hash["path"]["to"]["nested"] = value
692
+ current = item_hash
693
+ path_spec[0...-1].each do |key|
694
+ key_str = key.to_s
695
+ current[key_str] ||= {}
696
+ current = current[key_str]
697
+ end
698
+ current[path_spec.last.to_s] = serialized_value
699
+ elsif path_spec == :key
700
+ # Skip - key is used as the hash key
701
+ next
702
+ else
703
+ # Use the path_spec as a single key
704
+ item_hash[path_spec.to_s] = serialized_value
705
+ end
706
+ else
707
+ # No path_spec in root_mappings - use the serialized name from the mapping
708
+ serialized_name = attr_name.to_s
709
+ if item_class_mapping
710
+ mapping_rule = item_class_mapping.mappings.find do |m|
711
+ m.to == attr_name
712
+ end
713
+ serialized_name = mapping_rule.name.to_s if mapping_rule&.name
714
+ end
715
+
716
+ item_hash[serialized_name] = serialized_value
717
+ end
718
+ end
719
+ end
720
+
721
+ parent[key_value.to_s] = item_hash unless item_hash.empty?
722
+ end
723
+ end
724
+
725
+ return
726
+ end
727
+
728
+ # Check if this is a keyed collection (map_key feature)
729
+ child_mappings = rule.collection_info && rule.collection_info[:child_mappings]
730
+ key_attribute = keyed_collection_key_attribute(child_mappings)
731
+
732
+ if key_attribute
733
+ # Serialize as hash keyed by the key attribute
734
+ create_keyed_collection_element(parent, rule, items, key_attribute,
735
+ child_mappings, options)
736
+ else
737
+ # Serialize as array (default)
738
+ create_array_collection_element(parent, rule, items, options)
739
+ end
740
+ end
741
+
742
+ # Create a keyed collection element (map_key feature)
743
+ #
744
+ # @param parent [Lutaml::KeyValue::DataModel::Element] Parent element
745
+ # @param rule [CompiledRule] The rule
746
+ # @param items [Array] The collection items
747
+ # @param key_attribute [Symbol] The attribute to use as hash key
748
+ # @param child_mappings [Hash] The child mappings configuration
749
+ # @param options [Hash] Options
750
+ def create_keyed_collection_element(parent, rule, items, key_attribute,
751
+ child_mappings, options)
752
+ # Create hash to hold keyed items
753
+ keyed_hash = {}
754
+
755
+ # Check if there's a value mapping (map_value as_attribute: :name)
756
+ # This means we should serialize just the specified attribute value, not the full item hash
757
+ value_attribute = nil
758
+ child_mappings&.each do |attr_name, mapping_type|
759
+ value_attribute = attr_name if mapping_type == :value
760
+ end
761
+
762
+ if ENV["DEBUG_KEYED_COLLECTION"]
763
+ puts "create_keyed_collection_element: items.count=#{items.count}, key_attribute=#{key_attribute}, value_attribute=#{value_attribute.inspect}"
764
+ end
765
+
766
+ items.each do |item|
767
+ # Get the key value from the item
768
+ key_value = if item.is_a?(Lutaml::Model::Serialize) && item.class.attributes.key?(key_attribute)
769
+ item.public_send(key_attribute)
770
+ end
771
+
772
+ if ENV["DEBUG_KEYED_COLLECTION"]
773
+ puts " item: #{item.inspect}, key_value=#{key_value.inspect}"
774
+ end
775
+
776
+ next if key_value.nil?
777
+
778
+ # If there's a value mapping, serialize just that attribute value
779
+ if value_attribute
780
+ attr_value = if item.is_a?(Lutaml::Model::Serialize) && item.class.attributes.key?(value_attribute)
781
+ item.public_send(value_attribute)
782
+ end
783
+ next if attr_value.nil? || Lutaml::Model::Utils.uninitialized?(attr_value)
784
+
785
+ # Get the attribute definition for proper serialization
786
+ attr_def = nil
787
+ item_class = item.class
788
+ if item_class.is_a?(Class) && item_class.include?(Lutaml::Model::Serialize)
789
+ attr_def = item_class.attributes(register_id)&.[](value_attribute)
790
+ end
791
+
792
+ # Serialize the attribute value
793
+ serialized_value = if attr_def
794
+ serialize_collection_item_value(attr_value,
795
+ attr_def, options)
796
+ else
797
+ attr_value
798
+ end
799
+
800
+ unless serialized_value.nil?
801
+ keyed_hash[key_value.to_s] =
802
+ serialized_value
803
+ end
804
+ else
805
+ # No value mapping - serialize all attributes as a hash
806
+ item_hash = {}
807
+
808
+ # Check if child_mappings only contains :key/:value (no nested paths)
809
+ # In that case, we should also serialize other attributes not in child_mappings
810
+ has_nested_paths = child_mappings&.any? do |_, path_spec|
811
+ path_spec.is_a?(Array)
812
+ end
813
+
814
+ # Use child_mappings to determine where each attribute goes in the nested hash
815
+ if child_mappings && (has_nested_paths || child_mappings.any? do |_, path_spec|
816
+ path_spec != :key && path_spec != :value
817
+ end)
818
+ # child_mappings format: { attr_name => path_spec }
819
+ # where path_spec can be:
820
+ # - :key (used as hash key, already handled)
821
+ # - :value (use the value directly)
822
+ # - [:path, :to, :nested] (nested path)
823
+ # - :simple (single key, same as attr_name)
824
+
825
+ if ENV["DEBUG_KEYED_COLLECTION"]
826
+ puts " Using child_mappings: #{child_mappings.inspect}"
827
+ end
828
+
829
+ child_mappings.each do |attr_name, path_spec|
830
+ # Skip :key mappings - they're used as the hash key
831
+ next if path_spec == :key
832
+ # Skip :value mappings - handled separately
833
+ next if path_spec == :value
834
+
835
+ # Get the attribute value
836
+ attr_value = if item.is_a?(Lutaml::Model::Serialize) && item.class.attributes.key?(attr_name)
837
+ item.public_send(attr_name)
838
+ end
839
+
840
+ if ENV["DEBUG_KEYED_COLLECTION"]
841
+ puts " #{attr_name}: path_spec=#{path_spec.inspect}, attr_value=#{attr_value.inspect}"
842
+ end
843
+
844
+ next if attr_value.nil? || Lutaml::Model::Utils.uninitialized?(attr_value)
845
+
846
+ # Get the attribute definition for proper serialization
847
+ attr_def = nil
848
+ item_class = item.class
849
+ if item_class.is_a?(Class) && item_class.include?(Lutaml::Model::Serialize)
850
+ attr_def = item_class.attributes(register_id)&.[](attr_name)
851
+ end
852
+
853
+ # Serialize the attribute value
854
+ serialized_value = if attr_def
855
+ serialize_collection_item_value(
856
+ attr_value, attr_def, options
857
+ )
858
+ else
859
+ attr_value
860
+ end
861
+
862
+ next if serialized_value.nil?
863
+
864
+ # Build the nested hash structure based on path_spec
865
+ # path_spec can be:
866
+ # - [:path, :to, :nested] - array of path segments
867
+ # - :simple - single key
868
+ if path_spec.is_a?(Array)
869
+ # Build nested structure: [:path, :to, :nested] -> item_hash["path"]["to"]["nested"] = value
870
+ current = item_hash
871
+ path_spec[0...-1].each do |key|
872
+ key_str = key.to_s
873
+ current[key_str] ||= {}
874
+ current = current[key_str]
875
+ end
876
+ current[path_spec.last.to_s] = serialized_value
877
+ else
878
+ # Single key - use attr_name as key
879
+ item_hash[attr_name.to_s] = serialized_value
880
+ end
881
+ end
882
+ end
883
+
884
+ # Always serialize all attributes (as fallback) for keyed collections
885
+ # This handles the case where child_mappings only has :key mapping
886
+ item_class = item.class
887
+ if item_class.is_a?(Class) && item_class.include?(Lutaml::Model::Serialize)
888
+ if ENV["DEBUG_KEYED_COLLECTION"]
889
+ puts " item_class.attributes(#{register_id}): #{item_class.attributes(register_id).inspect}"
890
+ end
891
+ item_class.attributes(register_id).each do |attr_name, attr_def|
892
+ # Skip the key attribute since it's used as the hash key
893
+ next if attr_name == key_attribute
894
+ # Skip attributes already processed by child_mappings
895
+ next if child_mappings&.key?(attr_name)
896
+
897
+ attr_value = item.public_send(attr_name)
898
+
899
+ if ENV["DEBUG_KEYED_COLLECTION"]
900
+ puts " #{attr_name}: attr_value=#{attr_value.inspect}"
901
+ end
902
+
903
+ next if attr_value.nil? || Lutaml::Model::Utils.uninitialized?(attr_value)
904
+
905
+ # Serialize the attribute value
906
+ serialized_value = serialize_collection_item_value(attr_value,
907
+ attr_def, options)
908
+ if ENV["DEBUG_KEYED_COLLECTION"]
909
+ puts " serialized_value=#{serialized_value.inspect}"
910
+ end
911
+ unless serialized_value.nil?
912
+ item_hash[attr_name.to_s] =
913
+ serialized_value
914
+ end
915
+ end
916
+ end
917
+
918
+ if ENV["DEBUG_KEYED_COLLECTION"]
919
+ puts " item_hash: #{item_hash.inspect}"
920
+ end
921
+
922
+ # Add to keyed hash
923
+ keyed_hash[key_value.to_s] = item_hash unless item_hash.empty?
924
+ end
925
+ end
926
+
927
+ if ENV["DEBUG_KEYED_COLLECTION"]
928
+ puts " keyed_hash: #{keyed_hash.inspect}"
929
+ end
930
+
931
+ parent[rule.serialized_name] = keyed_hash
932
+ end
933
+
934
+ # Create an array collection element (default)
935
+ #
936
+ # @param parent [Lutaml::KeyValue::DataModel::Element] Parent element
937
+ # @param rule [CompiledRule] The rule
938
+ # @param items [Array] The collection items
939
+ # @param options [Hash] Options
940
+ def create_array_collection_element(parent, rule, items, options)
941
+ # children_to_array semantics directly: always an array,
942
+ # nil children skipped (explicit nil check — booleans matter).
943
+ built = items.each_with_object([]) do |item, memo|
944
+ child_value = create_value_for_item(rule, item, options)
945
+ memo << child_value unless child_value.nil?
946
+ end
947
+ parent[rule.serialized_name] = built
948
+ end
949
+
950
+ # Get the key attribute for a keyed collection from child_mappings
951
+ #
952
+ # @param child_mappings [Hash] The child mappings (e.g., { id: :key })
953
+ # @return [Symbol, nil] The attribute name to use as key, or nil
954
+ def keyed_collection_key_attribute(child_mappings)
955
+ return nil unless child_mappings
956
+
957
+ # Find the attribute mapped to :key
958
+ child_mappings.each do |attr_name, mapping|
959
+ return attr_name.to_sym if mapping == :key
960
+ end
961
+
962
+ nil
963
+ end
964
+
965
+ # Serialize a collection item value (for keyed collections)
966
+ #
967
+ # @param value [Object] The value to serialize
968
+ # @param attr_def [Attribute] The attribute definition
969
+ # @param options [Hash] Options
970
+ # @return [Object] The serialized value
971
+ def serialize_collection_item_value(value, attr_def, options)
972
+ return nil if value.nil? || Lutaml::Model::Utils.uninitialized?(value)
973
+
974
+ # Check if this is a collection attribute
975
+ attr_type = attr_def.type(register_id)
976
+ if attr_def.collection?
977
+ # For collections, check if it's a collection of Serialize models
978
+ if attr_type.is_a?(Class) && attr_type < Lutaml::Model::Serialize
979
+ # Create child transformation for the item type
980
+ mapping = attr_type.mappings_for(format, register_id)
981
+ child_transformation = self.class.new(attr_type, mapping, format,
982
+ register)
983
+
984
+ # Serialize each item in the collection
985
+ items = Array(value)
986
+ if items.empty?
987
+ []
988
+ else
989
+ # For keyed collections (with child_mappings), serialize as hash
990
+ # For regular collections, serialize as array
991
+ # We need to check if the mapping has child_mappings for this attribute
992
+ # Since we don't have direct access to the parent mapping here,
993
+ # serialize as array for now (default behavior)
994
+ items.map do |item|
995
+ child_transformation.transform(item, options)
996
+ end
997
+ end
998
+ else
999
+ # Primitive collection - return as-is (already an array)
1000
+ value
1001
+ end
1002
+ elsif attr_type.is_a?(Class) && attr_type < Lutaml::Model::Serialize
1003
+ # Single value - check if it's a nested model
1004
+ mapping = attr_type.mappings_for(format, register_id)
1005
+ child_transformation = self.class.new(attr_type, mapping, format,
1006
+ register)
1007
+ child_transformation.transform(value, options)
1008
+ # Use the transformation to serialize the nested model
1009
+ elsif attr_type.is_a?(Class) && attr_type < Lutaml::Model::Type::Value
1010
+ wrapped_value = attr_type.new(value)
1011
+ wrapped_value.public_send(:"to_#{format}")
1012
+ else
1013
+ value
1014
+ end
1015
+ end
1016
+
1017
+ # Create a value element
1018
+ #
1019
+ # @param parent [Lutaml::KeyValue::DataModel::Element] Parent element
1020
+ # @param rule [CompiledRule] The rule
1021
+ # @param value [Object] The value
1022
+ # @param options [Hash] Options
1023
+ def create_value_element(parent, rule, value, options)
1024
+ to_map = (rule.option(:value_map) || {})[:to] || {}
1025
+
1026
+ # Handle value_map conversions for nil/uninitialized/empty values.
1027
+ # Skip logic (should_skip_value?) already filters omitted cases,
1028
+ # so here we only handle render directives.
1029
+ if value.nil?
1030
+ nil_mapping = to_map[:nil]
1031
+ case nil_mapping
1032
+ when :omitted
1033
+ return
1034
+ when :nil
1035
+ parent[rule.serialized_name] = nil
1036
+ return
1037
+ when :empty
1038
+ parent[rule.serialized_name] = ""
1039
+ return
1040
+ end
1041
+
1042
+ # nil with no mapping → skip (default behavior)
1043
+ return
1044
+ elsif Lutaml::Model::Utils.uninitialized?(value)
1045
+ omitted_mapping = to_map[:omitted]
1046
+ if omitted_mapping == :nil
1047
+ parent[rule.serialized_name] = nil
1048
+ return
1049
+ elsif omitted_mapping == :empty
1050
+ parent[rule.serialized_name] = ""
1051
+ return
1052
+ end
1053
+ # uninitialized with no/omitted mapping → skip (default behavior)
1054
+ return
1055
+ elsif Lutaml::Model::Utils.empty?(value)
1056
+ empty_mapping = to_map[:empty]
1057
+ if empty_mapping == :nil
1058
+ parent[rule.serialized_name] = nil
1059
+ return
1060
+ elsif empty_mapping == :omitted
1061
+ return
1062
+ end
1063
+ # empty with :empty or no mapping → fall through to normal serialization
1064
+ end
1065
+
1066
+ # Normal value serialization
1067
+ child_value = create_value_for_item(rule, value, options)
1068
+
1069
+ parent[rule.serialized_name] = child_value unless child_value.nil?
1070
+ end
1071
+
1072
+ # Create value for an item (handles nested models and primitives)
1073
+ #
1074
+ # @param rule [CompiledRule] The rule
1075
+ # @param value [Object] The value
1076
+ # @param options [Hash] Options
1077
+ # @return [Object] The value (could be Hash, primitive, or KeyValueElement)
1078
+ def coerce_accepted_nested_value(value, declared_class)
1079
+ NestedValueCoercion.coerce(value, declared_class)
1080
+ end
1081
+
1082
+ # Child transformations memoized on this transformation instance:
1083
+ # the factory binds this instance's mapping/format/register, so
1084
+ # the memo is register-safe, and building one per serialized node
1085
+ # is a Transformation per nested model per instance.
1086
+ def transformation_for_type(type_class)
1087
+ (@lutaml_type_transformations ||= {})[type_class] ||=
1088
+ build_child_transformation(type_class)
1089
+ end
1090
+
1091
+ def create_value_for_item(rule, value, options)
1092
+ return nil if value.nil?
1093
+
1094
+ # Union: dispatch on the value's own class (stateless, like polymorphism).
1095
+ # A model member serializes via its class; a scalar member emits as-is.
1096
+ union = Lutaml::Model::Type::Union.rule?(rule)
1097
+ is_nested_model = if union
1098
+ value.is_a?(Lutaml::Model::Serialize)
1099
+ else
1100
+ rule.attribute_type.is_a?(Class) &&
1101
+ rule.attribute_type < Lutaml::Model::Serialize
1102
+ end
1103
+
1104
+ if is_nested_model && !value.is_a?(Lutaml::Model::Serialize)
1105
+ # The KV mirror of the XML lane's #971 collapse: a tolerated
1106
+ # singular attribute holding an over-assigned collection
1107
+ # serializes its leading value instead of raising.
1108
+ attr = if model_class.respond_to?(:attributes)
1109
+ model_class.attributes[rule.attribute_name.to_sym]
1110
+ end
1111
+ value = value.first if attr&.tolerates_singular_overflow?(value)
1112
+ end
1113
+
1114
+ if is_nested_model
1115
+ # Validate that value matches the expected type
1116
+ # There are three valid cases:
1117
+ # 1. attribute_type is a mapper class (has model method) and value is an instance of that model
1118
+ # 2. attribute_type is a regular Serializable class and value is an instance of it (or subclass)
1119
+ # 3. value's class is a registered type substitution for attribute_type
1120
+ context = Lutaml::Model::GlobalContext.context(register_id)
1121
+ subs = context.substitution_for(rule.attribute_type)
1122
+ uses_type_substitution = subs.any? { |s| s.to_type == value.class }
1123
+
1124
+ if rule.attribute_type.is_a?(Class) && rule.attribute_type.include?(Lutaml::Model::Serialize) && rule.attribute_type.model
1125
+ # Mapper class: value should be an instance of the mapped model
1126
+ # or a valid substituted type
1127
+ unless value.is_a?(rule.attribute_type.model) || uses_type_substitution
1128
+ value = coerce_accepted_nested_value(value, rule.attribute_type.model)
1129
+ unless value.is_a?(rule.attribute_type.model)
1130
+ msg = "attribute '#{rule.attribute_name}' value is a '#{value.class}' but should be a '#{rule.attribute_type.model}'"
1131
+ raise Lutaml::Model::IncorrectModelError, msg
1132
+ end
1133
+ end
1134
+ else
1135
+ # Regular Serializable class: value should be a Serialize instance
1136
+ # or a valid substituted type
1137
+ unless value.is_a?(Lutaml::Model::Serialize) || uses_type_substitution
1138
+ value = coerce_accepted_nested_value(value, rule.attribute_type)
1139
+ unless value.is_a?(Lutaml::Model::Serialize)
1140
+ msg = "attribute '#{rule.attribute_name}' value is a '#{value.class}' but should be a kind of 'Lutaml::Model::Serialize'"
1141
+ raise Lutaml::Model::IncorrectModelError, msg
1142
+ end
1143
+ end
1144
+ end
1145
+
1146
+ # Use the actual runtime type for polymorphism support
1147
+ # If value is a subclass of the declared type, use its mappings instead
1148
+ # Also handle type substitution the same way
1149
+ actual_type = value.class
1150
+ uses_polymorphism = union ||
1151
+ (actual_type != rule.attribute_type &&
1152
+ actual_type < rule.attribute_type) || uses_type_substitution
1153
+
1154
+ # Get child transformation - may be cached or need to create
1155
+ child_transformation = rule.child_transformation
1156
+
1157
+ # If not cached (e.g., due to cycles) or using polymorphism, create it now
1158
+ if !child_transformation || uses_polymorphism
1159
+ # For polymorphic types, use the actual runtime type's mappings
1160
+ type_for_mapping = uses_polymorphism ? actual_type : rule.attribute_type
1161
+ child_transformation = transformation_for_type(type_for_mapping)
1162
+ end
1163
+
1164
+ if child_transformation
1165
+ child_root = child_transformation.transform(value, options)
1166
+ # transform emits the content hash directly (TODO.perf 19);
1167
+ # an empty serialization still returns nil so render_nil:
1168
+ # false keeps working for nested models.
1169
+ child_root.empty? ? nil : child_root
1170
+ else
1171
+ # Fallback: serialize as primitive
1172
+ serialize_value(value, rule)
1173
+ end
1174
+ elsif union
1175
+ # Union scalar: serialize through the value type matching the value's
1176
+ # own class so output is canonical (e.g. BigDecimal -> "1.5"), not a
1177
+ # raw Ruby object.
1178
+ Lutaml::Model::Type::Union.serialize_scalar(value, format)
1179
+ else
1180
+ # Serialize primitive value
1181
+ serialize_value(value, rule)
1182
+ end
1183
+ end
1184
+
1185
+ # Handle raw mapping (map_all directive)
1186
+ #
1187
+ # Raw mappings parse the stored content (JSON/YAML/TOML string) and merge it
1188
+ # directly into the parent element, rather than creating a child element.
1189
+ #
1190
+ # @param parent [Lutaml::KeyValue::DataModel::Element] Parent element
1191
+ # @param value [String] The raw content (JSON/YAML/TOML string)
1192
+ # @param options [Hash] Options
1193
+ def handle_raw_mapping(parent, value, options)
1194
+ return if value.nil? || Lutaml::Model::Utils.uninitialized?(value)
1195
+ return if Lutaml::Model::Utils.empty?(value)
1196
+
1197
+ # Get the adapter for the current format and parse the raw content
1198
+ adapter = Lutaml::Model::Config.adapter_for(format)
1199
+ parsed_content = adapter.parse(value, options)
1200
+
1201
+ # Merge the parsed content into the parent element
1202
+ # For each key-value pair in the parsed content, add as a child element
1203
+ if parsed_content.is_a?(::Hash)
1204
+ parsed_content.each do |key, val|
1205
+ parent[key.to_s] = val
1206
+ end
1207
+ elsif !parsed_content.nil?
1208
+ # A raw mapping's content must be a key-value document — it is
1209
+ # merged into the parent by key. Any other shape (an Array, a
1210
+ # scalar) has no representation here; serializing it under a
1211
+ # synthetic key would leak that key into the document.
1212
+ raise ArgumentError,
1213
+ "raw mapping content must parse to a Hash, got " \
1214
+ "#{parsed_content.class}"
1215
+ end
1216
+ end
1217
+
1218
+ # Serialize a value to appropriate representation
1219
+ #
1220
+ # @param value [Object] The value to serialize
1221
+ # @param rule [CompiledRule] The rule
1222
+ # @return [Object] Serialized value
1223
+ def serialize_value(value, rule)
1224
+ return nil if value.nil?
1225
+ return nil if Lutaml::Model::Utils.uninitialized?(value)
1226
+
1227
+ # Rule-invariant resolution (attribute lookup, Reference probe,
1228
+ # nested-type class) is compiled once per rule — the per-value
1229
+ # hash lookups dominated primitive-heavy serialization.
1230
+ # Transformation freezes itself after compile; the plan cache
1231
+ # lives on the ValueSerializer (same model_class/register_id).
1232
+ plan = value_serializer.serialize_value_plan(rule)
1233
+
1234
+ if plan[:reference]
1235
+ return plan[:attr].serialize(value, format, register_id, {})
1236
+ end
1237
+
1238
+ # Validate that value is an instance of the expected Serializable type
1239
+ # When attribute_type is a Serializable class, value must be an instance of that class
1240
+ if plan[:nested]
1241
+ unless value.is_a?(rule.attribute_type)
1242
+ value = coerce_accepted_nested_value(value, rule.attribute_type)
1243
+ unless value.is_a?(rule.attribute_type)
1244
+ msg = "attribute '#{rule.attribute_name}' value is a '#{value.class}' but should be a '#{rule.attribute_type}'"
1245
+ raise Lutaml::Model::IncorrectModelError, msg
1246
+ end
1247
+ end
1248
+
1249
+ # Value is a valid Serialize instance - serialize it using its own to_#{format} method
1250
+ return value.public_send(:"to_#{format}")
1251
+ end
1252
+
1253
+ # Wrap value in type and call to_#{format} instance method (like legacy Attribute#serialize_value)
1254
+ # This allows custom type subclasses to override to_json, to_yaml, etc.
1255
+ if rule.attribute_type.is_a?(Class) && rule.attribute_type < Lutaml::Model::Type::Value
1256
+ type = rule.attribute_type
1257
+ # Identity fast path (TODO.perf/07): a builtin type with no custom
1258
+ # to_<format>/from_<format> behavior emits an already-native value
1259
+ # unchanged — the wrap only re-casts and re-emits it.
1260
+ native = NATIVE_VALUE_CLASS[type]
1261
+ if native && value.instance_of?(native) &&
1262
+ !::Lutaml::Model::Type::Value
1263
+ .format_type_serializer_for(format, type)&.fetch(:to, nil) &&
1264
+ !::Lutaml::Model::Attribute.custom_from_probe?(type)
1265
+ return value
1266
+ end
1267
+
1268
+ wrapped_value = type.new(value)
1269
+ wrapped_value.public_send(:"to_#{format}")
1270
+ else
1271
+ value
1272
+ end
1273
+ end
1274
+ end
1275
+ end
1276
+ end