lutaml 0.11.7 → 0.11.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (881) hide show
  1. checksums.yaml +4 -4
  2. data/.rubocop.yml +20 -0
  3. data/.rubocop_todo.yml +0 -1
  4. data/Gemfile +32 -5
  5. data/README.adoc +3 -3
  6. data/README.md +6 -8
  7. data/Rakefile +41 -1
  8. data/bin/console +0 -1
  9. data/exe/lutaml-lml +6 -0
  10. data/exe/lutaml-lml-lsp +11 -0
  11. data/lib/compat/opal/generate_boot.rb +132 -0
  12. data/lib/compat/opal/js_bundle_entry.rb +42 -0
  13. data/lib/compat/opal/lutaml_model_boot.rb +540 -0
  14. data/lib/compat/opal/monitor.rb +31 -0
  15. data/lib/compat/opal/moxml/adapter/customized_rexml/entity_reference.rb +9 -0
  16. data/lib/compat/opal/moxml/adapter/customized_rexml/formatter.rb +225 -0
  17. data/lib/compat/opal/moxml/adapter/customized_rexml.rb +11 -0
  18. data/lib/compat/opal/moxml_boot.rb +68 -0
  19. data/lib/compat/opal/objectspace_shim.rb +23 -0
  20. data/lib/compat/opal/rexml/namespace.rb +59 -0
  21. data/lib/compat/opal/rexml/parsers/baseparser.rb +1016 -0
  22. data/lib/compat/opal/rexml/source.rb +214 -0
  23. data/lib/compat/opal/rexml/text.rb +426 -0
  24. data/lib/compat/opal/rexml/xmltokens.rb +45 -0
  25. data/lib/compat/opal/rexml_compat.rb +85 -0
  26. data/lib/compat/opal/yaml_compat.rb +32 -0
  27. data/lib/lutaml/hash_format/adapter/document.rb +10 -0
  28. data/lib/lutaml/hash_format/adapter/mapping.rb +17 -0
  29. data/lib/lutaml/hash_format/adapter/mapping_rule.rb +9 -0
  30. data/lib/lutaml/hash_format/adapter/standard_adapter.rb +17 -0
  31. data/lib/lutaml/hash_format/adapter/transform.rb +9 -0
  32. data/lib/lutaml/hash_format/adapter.rb +13 -0
  33. data/lib/lutaml/hash_format/format.rb +29 -0
  34. data/lib/lutaml/hash_format/type/serializers.rb +24 -0
  35. data/lib/lutaml/hash_format.rb +7 -0
  36. data/lib/lutaml/json/adapter/document.rb +13 -0
  37. data/lib/lutaml/json/adapter/mapping.rb +17 -0
  38. data/lib/lutaml/json/adapter/mapping_rule.rb +9 -0
  39. data/lib/lutaml/json/adapter/multi_json_adapter.rb +45 -0
  40. data/lib/lutaml/json/adapter/oj_adapter.rb +41 -0
  41. data/lib/lutaml/json/adapter/standard_adapter.rb +43 -0
  42. data/lib/lutaml/json/adapter/transform.rb +9 -0
  43. data/lib/lutaml/json/adapter/yeptris_adapter.rb +74 -0
  44. data/lib/lutaml/json/adapter.rb +21 -0
  45. data/lib/lutaml/json/format.rb +61 -0
  46. data/lib/lutaml/json/generator_options.rb +62 -0
  47. data/lib/lutaml/json/schema/json_schema.rb +62 -0
  48. data/lib/lutaml/json/schema.rb +9 -0
  49. data/lib/lutaml/json/type/serializers.rb +72 -0
  50. data/lib/lutaml/json.rb +7 -0
  51. data/lib/lutaml/jsonl/adapter/document.rb +14 -0
  52. data/lib/lutaml/jsonl/adapter/mapping.rb +17 -0
  53. data/lib/lutaml/jsonl/adapter/mapping_rule.rb +9 -0
  54. data/lib/lutaml/jsonl/adapter/standard_adapter.rb +34 -0
  55. data/lib/lutaml/jsonl/adapter/transform.rb +26 -0
  56. data/lib/lutaml/jsonl/adapter.rb +13 -0
  57. data/lib/lutaml/jsonl/format.rb +22 -0
  58. data/lib/lutaml/jsonl.rb +7 -0
  59. data/lib/lutaml/jsonld/adapter.rb +31 -0
  60. data/lib/lutaml/jsonld.rb +20 -0
  61. data/lib/lutaml/key_value/adapter/hash/document.rb +13 -0
  62. data/lib/lutaml/key_value/adapter/hash/mapping.rb +17 -0
  63. data/lib/lutaml/key_value/adapter/hash/mapping_rule.rb +9 -0
  64. data/lib/lutaml/key_value/adapter/hash/standard_adapter.rb +19 -0
  65. data/lib/lutaml/key_value/adapter/hash/transform.rb +10 -0
  66. data/lib/lutaml/key_value/adapter/hash.rb +15 -0
  67. data/lib/lutaml/key_value/adapter/json/document.rb +16 -0
  68. data/lib/lutaml/key_value/adapter/json/mapping.rb +22 -0
  69. data/lib/lutaml/key_value/adapter/json/mapping_rule.rb +14 -0
  70. data/lib/lutaml/key_value/adapter/json/multi_json_adapter.rb +54 -0
  71. data/lib/lutaml/key_value/adapter/json/oj_adapter.rb +46 -0
  72. data/lib/lutaml/key_value/adapter/json/standard_adapter.rb +47 -0
  73. data/lib/lutaml/key_value/adapter/json/transform.rb +14 -0
  74. data/lib/lutaml/key_value/adapter/json/yeptris_adapter.rb +15 -0
  75. data/lib/lutaml/key_value/adapter/json.rb +24 -0
  76. data/lib/lutaml/key_value/adapter/jsonl/document.rb +16 -0
  77. data/lib/lutaml/key_value/adapter/jsonl/mapping.rb +17 -0
  78. data/lib/lutaml/key_value/adapter/jsonl/mapping_rule.rb +9 -0
  79. data/lib/lutaml/key_value/adapter/jsonl/standard_adapter.rb +36 -0
  80. data/lib/lutaml/key_value/adapter/jsonl/transform.rb +26 -0
  81. data/lib/lutaml/key_value/adapter/jsonl.rb +17 -0
  82. data/lib/lutaml/key_value/adapter/toml/document.rb +13 -0
  83. data/lib/lutaml/key_value/adapter/toml/mapping.rb +26 -0
  84. data/lib/lutaml/key_value/adapter/toml/mapping_rule.rb +9 -0
  85. data/lib/lutaml/key_value/adapter/toml/teptris_adapter.rb +36 -0
  86. data/lib/lutaml/key_value/adapter/toml/toml_rb_adapter.rb +34 -0
  87. data/lib/lutaml/key_value/adapter/toml/tomlib_adapter.rb +40 -0
  88. data/lib/lutaml/key_value/adapter/toml/transform.rb +10 -0
  89. data/lib/lutaml/key_value/adapter/toml.rb +22 -0
  90. data/lib/lutaml/key_value/adapter/yaml/document.rb +12 -0
  91. data/lib/lutaml/key_value/adapter/yaml/mapping.rb +17 -0
  92. data/lib/lutaml/key_value/adapter/yaml/mapping_rule.rb +9 -0
  93. data/lib/lutaml/key_value/adapter/yaml/standard_adapter.rb +35 -0
  94. data/lib/lutaml/key_value/adapter/yaml/transform.rb +10 -0
  95. data/lib/lutaml/key_value/adapter/yaml/yeptris_adapter.rb +15 -0
  96. data/lib/lutaml/key_value/adapter/yaml.rb +17 -0
  97. data/lib/lutaml/key_value/adapter/yamls/document.rb +16 -0
  98. data/lib/lutaml/key_value/adapter/yamls/mapping.rb +17 -0
  99. data/lib/lutaml/key_value/adapter/yamls/mapping_rule.rb +9 -0
  100. data/lib/lutaml/key_value/adapter/yamls/standard_adapter.rb +37 -0
  101. data/lib/lutaml/key_value/adapter/yamls/transform.rb +26 -0
  102. data/lib/lutaml/key_value/adapter/yamls.rb +17 -0
  103. data/lib/lutaml/key_value/adapter.rb +14 -0
  104. data/lib/lutaml/key_value/data_model/element.rb +225 -0
  105. data/lib/lutaml/key_value/data_model.rb +14 -0
  106. data/lib/lutaml/key_value/document.rb +28 -0
  107. data/lib/lutaml/key_value/format.rb +26 -0
  108. data/lib/lutaml/key_value/mapping.rb +393 -0
  109. data/lib/lutaml/key_value/mapping_rule.rb +95 -0
  110. data/lib/lutaml/key_value/transform.rb +1223 -0
  111. data/lib/lutaml/key_value/transformation/collection_serializer.rb +572 -0
  112. data/lib/lutaml/key_value/transformation/rule_compiler.rb +299 -0
  113. data/lib/lutaml/key_value/transformation/value_serializer.rb +399 -0
  114. data/lib/lutaml/key_value/transformation.rb +1276 -0
  115. data/lib/lutaml/key_value/transformation_builder.rb +30 -0
  116. data/lib/lutaml/key_value.rb +7 -0
  117. data/lib/lutaml/lml/association_label_resolver.rb +52 -0
  118. data/lib/lutaml/lml/cli.rb +506 -0
  119. data/lib/lutaml/lml/data_processor/attribute_processing.rb +133 -0
  120. data/lib/lutaml/lml/data_processor/collection_processing.rb +37 -0
  121. data/lib/lutaml/lml/data_processor/instance_processing.rb +77 -0
  122. data/lib/lutaml/lml/data_processor/value_declaration_processing.rb +70 -0
  123. data/lib/lutaml/lml/data_processor/value_processing.rb +103 -0
  124. data/lib/lutaml/lml/data_processor/view_processing.rb +26 -0
  125. data/lib/lutaml/lml/data_processor.rb +59 -0
  126. data/lib/lutaml/lml/diagnostic.rb +149 -0
  127. data/lib/lutaml/lml/document_builder.rb +481 -0
  128. data/lib/lutaml/lml/entity_types.rb +30 -0
  129. data/lib/lutaml/lml/executor/adapter_helpers.rb +45 -0
  130. data/lib/lutaml/lml/executor/condition_evaluator.rb +169 -0
  131. data/lib/lutaml/lml/executor/csv_adapter.rb +88 -0
  132. data/lib/lutaml/lml/executor/format_adapter.rb +54 -0
  133. data/lib/lutaml/lml/executor/xml_adapter.rb +102 -0
  134. data/lib/lutaml/lml/executor.rb +96 -0
  135. data/lib/lutaml/lml/format/adapter/document.rb +11 -0
  136. data/lib/lutaml/lml/format/adapter/mapping.rb +31 -0
  137. data/lib/lutaml/lml/format/adapter/standard_adapter.rb +162 -0
  138. data/lib/lutaml/lml/format/adapter/transform.rb +11 -0
  139. data/lib/lutaml/lml/format.rb +29 -0
  140. data/lib/lutaml/lml/formatter/base.rb +79 -0
  141. data/lib/lutaml/lml/formatter/canonical.rb +736 -0
  142. data/lib/lutaml/lml/formatter/elk.rb +45 -0
  143. data/lib/lutaml/lml/formatter/svg_pdf/path_parser.rb +134 -0
  144. data/lib/lutaml/lml/formatter/svg_pdf.rb +285 -0
  145. data/lib/lutaml/lml/formatter.rb +11 -0
  146. data/lib/lutaml/lml/grammar/lml.artifact.json +14993 -0
  147. data/lib/lutaml/lml/grammar/lml.parg +389 -0
  148. data/lib/lutaml/lml/grammar.rb +60 -0
  149. data/lib/lutaml/lml/has_attributes.rb +14 -0
  150. data/lib/lutaml/lml/import_resolver.rb +96 -0
  151. data/lib/lutaml/lml/layout/elk_engine.rb +15 -0
  152. data/lib/lutaml/lml/layout/elk_graph_builder.rb +129 -0
  153. data/lib/lutaml/lml/layout/elk_svg_markers.rb +45 -0
  154. data/lib/lutaml/lml/layout/elk_svg_renderer.rb +119 -0
  155. data/lib/lutaml/lml/layout/engine.rb +17 -0
  156. data/lib/lutaml/lml/layout.rb +12 -0
  157. data/lib/lutaml/lml/literal_value.rb +32 -0
  158. data/lib/lutaml/lml/lsp/conversions.rb +78 -0
  159. data/lib/lutaml/lml/lsp/keywords.rb +43 -0
  160. data/lib/lutaml/lml/lsp/server.rb +378 -0
  161. data/lib/lutaml/lml/lsp/store.rb +68 -0
  162. data/lib/lutaml/lml/lsp/transport.rb +53 -0
  163. data/lib/lutaml/lml/lsp.rb +16 -0
  164. data/lib/lutaml/lml/model_compiler/enums.rb +172 -0
  165. data/lib/lutaml/lml/model_compiler/hydration.rb +123 -0
  166. data/lib/lutaml/lml/model_compiler/serialization_mappings.rb +188 -0
  167. data/lib/lutaml/lml/model_compiler/string_formats.rb +42 -0
  168. data/lib/lutaml/lml/model_compiler/validation.rb +65 -0
  169. data/lib/lutaml/lml/model_compiler.rb +323 -0
  170. data/lib/lutaml/lml/models/action.rb +10 -0
  171. data/lib/lutaml/lml/models/association.rb +29 -0
  172. data/lib/lutaml/lml/models/cardinality.rb +10 -0
  173. data/lib/lutaml/lml/models/collection.rb +11 -0
  174. data/lib/lutaml/lml/models/constraint.rb +23 -0
  175. data/lib/lutaml/lml/models/data_type.rb +41 -0
  176. data/lib/lutaml/lml/models/derived_field.rb +14 -0
  177. data/lib/lutaml/lml/models/diagram.rb +20 -0
  178. data/lib/lutaml/lml/models/document.rb +84 -0
  179. data/lib/lutaml/lml/models/enum.rb +38 -0
  180. data/lib/lutaml/lml/models/fidelity.rb +10 -0
  181. data/lib/lutaml/lml/models/group.rb +11 -0
  182. data/lib/lutaml/lml/models/instance.rb +26 -0
  183. data/lib/lutaml/lml/models/instance_collection.rb +16 -0
  184. data/lib/lutaml/lml/models/instances_export.rb +10 -0
  185. data/lib/lutaml/lml/models/instances_import.rb +11 -0
  186. data/lib/lutaml/lml/models/mapping.rb +15 -0
  187. data/lib/lutaml/lml/models/mapping_rule.rb +16 -0
  188. data/lib/lutaml/lml/models/member_field.rb +14 -0
  189. data/lib/lutaml/lml/models/namespace.rb +16 -0
  190. data/lib/lutaml/lml/models/operation.rb +26 -0
  191. data/lib/lutaml/lml/models/operation_parameter.rb +12 -0
  192. data/lib/lutaml/lml/models/package.rb +26 -0
  193. data/lib/lutaml/lml/models/primitive_type.rb +33 -0
  194. data/lib/lutaml/lml/models/reference.rb +23 -0
  195. data/lib/lutaml/lml/models/serialization_mapping.rb +19 -0
  196. data/lib/lutaml/lml/models/string_format.rb +16 -0
  197. data/lib/lutaml/lml/models/top_element_attribute.rb +116 -0
  198. data/lib/lutaml/lml/models/uml_class.rb +85 -0
  199. data/lib/lutaml/lml/models/value.rb +15 -0
  200. data/lib/lutaml/lml/models/view_filter.rb +11 -0
  201. data/lib/lutaml/lml/models/view_import.rb +11 -0
  202. data/lib/lutaml/lml/parser.rb +19 -0
  203. data/lib/lutaml/lml/pipeline.rb +73 -0
  204. data/lib/lutaml/lml/positioned.rb +13 -0
  205. data/lib/lutaml/lml/preprocessor.rb +130 -0
  206. data/lib/lutaml/lml/quoting.rb +60 -0
  207. data/lib/lutaml/lml/source.rb +49 -0
  208. data/lib/lutaml/lml/source_position.rb +20 -0
  209. data/lib/lutaml/lml/symbol_index.rb +200 -0
  210. data/lib/lutaml/lml/transform.rb +119 -0
  211. data/lib/lutaml/lml/types/text_type.rb +28 -0
  212. data/lib/lutaml/lml/types.rb +10 -0
  213. data/lib/lutaml/lml/validator.rb +458 -0
  214. data/lib/lutaml/lml/version.rb +10 -0
  215. data/lib/lutaml/lml/view_resolution.rb +32 -0
  216. data/lib/lutaml/lml/view_resolver.rb +48 -0
  217. data/lib/lutaml/lml/yaml_parser.rb +17 -0
  218. data/lib/lutaml/lml.rb +130 -0
  219. data/lib/lutaml/model/adapter_resolver.rb +487 -0
  220. data/lib/lutaml/model/adapter_scope.rb +64 -0
  221. data/lib/lutaml/model/attribute.rb +1511 -0
  222. data/lib/lutaml/model/attribute_validator.rb +290 -0
  223. data/lib/lutaml/model/cached_type_resolver/concurrent_map_cache.rb +48 -0
  224. data/lib/lutaml/model/cached_type_resolver/mutex_hash_cache.rb +53 -0
  225. data/lib/lutaml/model/cached_type_resolver.rb +145 -0
  226. data/lib/lutaml/model/choice.rb +343 -0
  227. data/lib/lutaml/model/cli.rb +85 -0
  228. data/lib/lutaml/model/collection.rb +740 -0
  229. data/lib/lutaml/model/collection_handler.rb +157 -0
  230. data/lib/lutaml/model/comparable_model.rb +710 -0
  231. data/lib/lutaml/model/comparable_nil.rb +9 -0
  232. data/lib/lutaml/model/comparison.rb +15 -0
  233. data/lib/lutaml/model/compiled_rule.rb +242 -0
  234. data/lib/lutaml/model/config.rb +169 -0
  235. data/lib/lutaml/model/configuration.rb +138 -0
  236. data/lib/lutaml/model/consolidation/attribute_grouper.rb +44 -0
  237. data/lib/lutaml/model/consolidation/dispatcher.rb +45 -0
  238. data/lib/lutaml/model/consolidation/engine.rb +33 -0
  239. data/lib/lutaml/model/consolidation/pattern_chunker.rb +87 -0
  240. data/lib/lutaml/model/consolidation_map.rb +68 -0
  241. data/lib/lutaml/model/consolidation_rule/dispatch_block.rb +34 -0
  242. data/lib/lutaml/model/consolidation_rule/gather_rule.rb +17 -0
  243. data/lib/lutaml/model/consolidation_rule/pattern_content_rule.rb +15 -0
  244. data/lib/lutaml/model/consolidation_rule/pattern_element_rule.rb +17 -0
  245. data/lib/lutaml/model/consolidation_rule.rb +27 -0
  246. data/lib/lutaml/model/constants.rb +11 -0
  247. data/lib/lutaml/model/context_registry.rb +208 -0
  248. data/lib/lutaml/model/deep_dupable.rb +16 -0
  249. data/lib/lutaml/model/error/choice_lower_bound_error.rb +9 -0
  250. data/lib/lutaml/model/error/choice_upper_bound_error.rb +9 -0
  251. data/lib/lutaml/model/error/collection_count_out_of_range_error.rb +29 -0
  252. data/lib/lutaml/model/error/collection_true_missing_error.rb +16 -0
  253. data/lib/lutaml/model/error/element_count_out_of_range_error.rb +35 -0
  254. data/lib/lutaml/model/error/format_adapter_not_specified_error.rb +25 -0
  255. data/lib/lutaml/model/error/fraction_digits_error.rb +20 -0
  256. data/lib/lutaml/model/error/import_model_with_root_error.rb +9 -0
  257. data/lib/lutaml/model/error/incorrect_mapping_argument_error.rb +6 -0
  258. data/lib/lutaml/model/error/incorrect_sequence_error.rb +9 -0
  259. data/lib/lutaml/model/error/invalid_attribute_name_error.rb +15 -0
  260. data/lib/lutaml/model/error/invalid_attribute_options_error.rb +16 -0
  261. data/lib/lutaml/model/error/invalid_attribute_type_error.rb +98 -0
  262. data/lib/lutaml/model/error/invalid_choice_range_error.rb +18 -0
  263. data/lib/lutaml/model/error/invalid_format_error.rb +11 -0
  264. data/lib/lutaml/model/error/invalid_value_error.rb +18 -0
  265. data/lib/lutaml/model/error/length_error.rb +19 -0
  266. data/lib/lutaml/model/error/liquid_class_not_found_error.rb +9 -0
  267. data/lib/lutaml/model/error/liquid_drop_already_registered_error.rb +11 -0
  268. data/lib/lutaml/model/error/liquid_not_enabled_error.rb +9 -0
  269. data/lib/lutaml/model/error/mapping_already_exists_error.rb +6 -0
  270. data/lib/lutaml/model/error/mapping_attribute_missing_error.rb +6 -0
  271. data/lib/lutaml/model/error/mapping_attribute_type_error.rb +6 -0
  272. data/lib/lutaml/model/error/max_exclusive_error.rb +19 -0
  273. data/lib/lutaml/model/error/max_inclusive_error.rb +20 -0
  274. data/lib/lutaml/model/error/max_length_error.rb +20 -0
  275. data/lib/lutaml/model/error/min_exclusive_error.rb +19 -0
  276. data/lib/lutaml/model/error/min_inclusive_error.rb +20 -0
  277. data/lib/lutaml/model/error/min_length_error.rb +20 -0
  278. data/lib/lutaml/model/error/mixed_content_collection_error.rb +17 -0
  279. data/lib/lutaml/model/error/multiple_mappings_error.rb +6 -0
  280. data/lib/lutaml/model/error/no_attributes_defined_liquid_error.rb +9 -0
  281. data/lib/lutaml/model/error/no_mapping_found_error.rb +9 -0
  282. data/lib/lutaml/model/error/no_root_mapping_error.rb +10 -0
  283. data/lib/lutaml/model/error/no_root_namespace_error.rb +10 -0
  284. data/lib/lutaml/model/error/ordered_content_mapping_error.rb +17 -0
  285. data/lib/lutaml/model/error/pattern_not_matched_error.rb +17 -0
  286. data/lib/lutaml/model/error/polymorphic_error.rb +14 -0
  287. data/lib/lutaml/model/error/register/not_registrable_class_error.rb +11 -0
  288. data/lib/lutaml/model/error/required_attribute_missing_error.rb +9 -0
  289. data/lib/lutaml/model/error/restriction_error.rb +8 -0
  290. data/lib/lutaml/model/error/reverse_transform_block_not_defined_error.rb +6 -0
  291. data/lib/lutaml/model/error/reverse_transformation_declaration_error.rb +6 -0
  292. data/lib/lutaml/model/error/sorting_configuration_conflict_error.rb +9 -0
  293. data/lib/lutaml/model/error/total_digits_error.rb +20 -0
  294. data/lib/lutaml/model/error/transform_block_not_defined_error.rb +6 -0
  295. data/lib/lutaml/model/error/type/invalid_value_error.rb +21 -0
  296. data/lib/lutaml/model/error/type/max_bound_error.rb +20 -0
  297. data/lib/lutaml/model/error/type/max_exclusive_error.rb +20 -0
  298. data/lib/lutaml/model/error/type/max_length_error.rb +20 -0
  299. data/lib/lutaml/model/error/type/min_bound_error.rb +20 -0
  300. data/lib/lutaml/model/error/type/min_exclusive_error.rb +20 -0
  301. data/lib/lutaml/model/error/type/min_length_error.rb +20 -0
  302. data/lib/lutaml/model/error/type/pattern_not_matched_error.rb +18 -0
  303. data/lib/lutaml/model/error/type.rb +19 -0
  304. data/lib/lutaml/model/error/type_error.rb +9 -0
  305. data/lib/lutaml/model/error/type_not_enabled_error.rb +9 -0
  306. data/lib/lutaml/model/error/type_only_mapping_error.rb +13 -0
  307. data/lib/lutaml/model/error/type_only_namespace_error.rb +12 -0
  308. data/lib/lutaml/model/error/undefined_attribute_error.rb +9 -0
  309. data/lib/lutaml/model/error/union_schema_unsupported_error.rb +11 -0
  310. data/lib/lutaml/model/error/unknown_adapter_type_error.rb +95 -0
  311. data/lib/lutaml/model/error/unknown_discriminator_error.rb +11 -0
  312. data/lib/lutaml/model/error/unknown_mapping_error.rb +18 -0
  313. data/lib/lutaml/model/error/unknown_sequence_mapping_error.rb +9 -0
  314. data/lib/lutaml/model/error/unknown_type_error.rb +32 -0
  315. data/lib/lutaml/model/error/unresolvable_type_error.rb +27 -0
  316. data/lib/lutaml/model/error/unsupported_version_error.rb +14 -0
  317. data/lib/lutaml/model/error/validation_error.rb +20 -0
  318. data/lib/lutaml/model/error/validation_failed_error.rb +9 -0
  319. data/lib/lutaml/model/error.rb +8 -0
  320. data/lib/lutaml/model/errors.rb +38 -0
  321. data/lib/lutaml/model/evolution_steps.rb +85 -0
  322. data/lib/lutaml/model/finalization_cache.rb +51 -0
  323. data/lib/lutaml/model/format_registry.rb +218 -0
  324. data/lib/lutaml/model/global_context.rb +476 -0
  325. data/lib/lutaml/model/global_register.rb +142 -0
  326. data/lib/lutaml/model/hash.rb +15 -0
  327. data/lib/lutaml/model/import_registry.rb +250 -0
  328. data/lib/lutaml/model/instrumentation.rb +304 -0
  329. data/lib/lutaml/model/json.rb +25 -0
  330. data/lib/lutaml/model/json_adapter.rb +8 -0
  331. data/lib/lutaml/model/jsonl.rb +15 -0
  332. data/lib/lutaml/model/liquefiable.rb +198 -0
  333. data/lib/lutaml/model/liquid/indexed_access.rb +33 -0
  334. data/lib/lutaml/model/liquid/mapping.rb +30 -0
  335. data/lib/lutaml/model/liquid.rb +10 -0
  336. data/lib/lutaml/model/lml/document.rb +109 -0
  337. data/lib/lutaml/model/lml/exporter.rb +328 -0
  338. data/lib/lutaml/model/lml/rejected_error.rb +32 -0
  339. data/lib/lutaml/model/lml/round_trip.rb +49 -0
  340. data/lib/lutaml/model/lml.rb +40 -0
  341. data/lib/lutaml/model/mapping/listener.rb +126 -0
  342. data/lib/lutaml/model/mapping/mapping.rb +209 -0
  343. data/lib/lutaml/model/mapping/mapping_rule.rb +673 -0
  344. data/lib/lutaml/model/mapping/model_mapping.rb +133 -0
  345. data/lib/lutaml/model/mapping/model_mapping_rule.rb +57 -0
  346. data/lib/lutaml/model/mapping_hash.rb +80 -0
  347. data/lib/lutaml/model/model_transformer.rb +101 -0
  348. data/lib/lutaml/model/one_entry_cache.rb +57 -0
  349. data/lib/lutaml/model/organization.rb +29 -0
  350. data/lib/lutaml/model/register/model_tree_importer.rb +88 -0
  351. data/lib/lutaml/model/register/namespace_binding.rb +92 -0
  352. data/lib/lutaml/model/register.rb +589 -0
  353. data/lib/lutaml/model/registrable.rb +8 -0
  354. data/lib/lutaml/model/render_policy.rb +166 -0
  355. data/lib/lutaml/model/restriction_validation.rb +437 -0
  356. data/lib/lutaml/model/runtime_compatibility.rb +144 -0
  357. data/lib/lutaml/model/schema/base_schema.rb +77 -0
  358. data/lib/lutaml/model/schema/class_loader.rb +59 -0
  359. data/lib/lutaml/model/schema/compiled_output.rb +83 -0
  360. data/lib/lutaml/model/schema/decorators/attribute.rb +116 -0
  361. data/lib/lutaml/model/schema/decorators/choices.rb +29 -0
  362. data/lib/lutaml/model/schema/decorators/class_definition.rb +84 -0
  363. data/lib/lutaml/model/schema/decorators/definition_collection.rb +97 -0
  364. data/lib/lutaml/model/schema/decorators.rb +15 -0
  365. data/lib/lutaml/model/schema/definitions/attribute.rb +32 -0
  366. data/lib/lutaml/model/schema/definitions/choice.rb +20 -0
  367. data/lib/lutaml/model/schema/definitions/facet.rb +40 -0
  368. data/lib/lutaml/model/schema/definitions/group_import.rb +22 -0
  369. data/lib/lutaml/model/schema/definitions/member_walk.rb +33 -0
  370. data/lib/lutaml/model/schema/definitions/model.rb +40 -0
  371. data/lib/lutaml/model/schema/definitions/namespace.rb +24 -0
  372. data/lib/lutaml/model/schema/definitions/restricted_type.rb +32 -0
  373. data/lib/lutaml/model/schema/definitions/sequence.rb +19 -0
  374. data/lib/lutaml/model/schema/definitions/simple_content.rb +22 -0
  375. data/lib/lutaml/model/schema/definitions/transform_facet.rb +21 -0
  376. data/lib/lutaml/model/schema/definitions/type_ref.rb +20 -0
  377. data/lib/lutaml/model/schema/definitions/union_type.rb +28 -0
  378. data/lib/lutaml/model/schema/definitions/xml_root.rb +20 -0
  379. data/lib/lutaml/model/schema/definitions.rb +24 -0
  380. data/lib/lutaml/model/schema/file_writer.rb +73 -0
  381. data/lib/lutaml/model/schema/generator/definition.rb +98 -0
  382. data/lib/lutaml/model/schema/generator/definitions_collection.rb +117 -0
  383. data/lib/lutaml/model/schema/generator/properties_collection.rb +65 -0
  384. data/lib/lutaml/model/schema/generator/property.rb +182 -0
  385. data/lib/lutaml/model/schema/generator/ref.rb +24 -0
  386. data/lib/lutaml/model/schema/generator.rb +15 -0
  387. data/lib/lutaml/model/schema/helpers/template_helper.rb +49 -0
  388. data/lib/lutaml/model/schema/helpers.rb +11 -0
  389. data/lib/lutaml/model/schema/json_schema.rb +17 -0
  390. data/lib/lutaml/model/schema/json_schema_parser.rb +91 -0
  391. data/lib/lutaml/model/schema/module_nesting.rb +31 -0
  392. data/lib/lutaml/model/schema/namespace_naming.rb +46 -0
  393. data/lib/lutaml/model/schema/registry_generator.rb +115 -0
  394. data/lib/lutaml/model/schema/renderer.rb +38 -0
  395. data/lib/lutaml/model/schema/renderers/base.rb +41 -0
  396. data/lib/lutaml/model/schema/renderers/mappings.rb +78 -0
  397. data/lib/lutaml/model/schema/renderers/member_decls.rb +121 -0
  398. data/lib/lutaml/model/schema/renderers/model.rb +133 -0
  399. data/lib/lutaml/model/schema/renderers/namespace.rb +30 -0
  400. data/lib/lutaml/model/schema/renderers/registration.rb +64 -0
  401. data/lib/lutaml/model/schema/renderers/required_files_calculator.rb +94 -0
  402. data/lib/lutaml/model/schema/renderers/restricted_type.rb +218 -0
  403. data/lib/lutaml/model/schema/renderers/union.rb +83 -0
  404. data/lib/lutaml/model/schema/renderers.rb +20 -0
  405. data/lib/lutaml/model/schema/rnc_compiler/source_resolver.rb +51 -0
  406. data/lib/lutaml/model/schema/rnc_compiler.rb +64 -0
  407. data/lib/lutaml/model/schema/rng_compiler/define_classifier.rb +94 -0
  408. data/lib/lutaml/model/schema/rng_compiler/element_visitor.rb +412 -0
  409. data/lib/lutaml/model/schema/rng_compiler/member_collector.rb +30 -0
  410. data/lib/lutaml/model/schema/rng_compiler/rng_helpers.rb +160 -0
  411. data/lib/lutaml/model/schema/rng_compiler/value_type_resolver.rb +129 -0
  412. data/lib/lutaml/model/schema/rng_compiler.rb +225 -0
  413. data/lib/lutaml/model/schema/schema_builder/nokogiri.rb +41 -0
  414. data/lib/lutaml/model/schema/schema_builder/oga.rb +92 -0
  415. data/lib/lutaml/model/schema/shared_methods.rb +24 -0
  416. data/lib/lutaml/model/schema/templates/model.erb +9 -0
  417. data/lib/lutaml/model/schema/templates.rb +164 -0
  418. data/lib/lutaml/model/schema/xml_compiler/element_order.rb +42 -0
  419. data/lib/lutaml/model/schema/xml_compiler/registry_generator.rb +51 -0
  420. data/lib/lutaml/model/schema/xml_compiler/spec_builder/complex_types.rb +198 -0
  421. data/lib/lutaml/model/schema/xml_compiler/spec_builder/members.rb +249 -0
  422. data/lib/lutaml/model/schema/xml_compiler/spec_builder/simple_types.rb +185 -0
  423. data/lib/lutaml/model/schema/xml_compiler/spec_builder.rb +186 -0
  424. data/lib/lutaml/model/schema/xml_compiler/supported_data_types.rb +100 -0
  425. data/lib/lutaml/model/schema/xml_compiler.rb +109 -0
  426. data/lib/lutaml/model/schema/yaml_schema.rb +17 -0
  427. data/lib/lutaml/model/schema.rb +88 -0
  428. data/lib/lutaml/model/schema_location.rb +18 -0
  429. data/lib/lutaml/model/sequence.rb +220 -0
  430. data/lib/lutaml/model/serializable.rb +46 -0
  431. data/lib/lutaml/model/serialization_adapter.rb +24 -0
  432. data/lib/lutaml/model/serialize/attribute_definition.rb +897 -0
  433. data/lib/lutaml/model/serialize/builder.rb +258 -0
  434. data/lib/lutaml/model/serialize/conversion_caching.rb +129 -0
  435. data/lib/lutaml/model/serialize/deserialization_context.rb +51 -0
  436. data/lib/lutaml/model/serialize/enum_handling.rb +171 -0
  437. data/lib/lutaml/model/serialize/format_conversion.rb +624 -0
  438. data/lib/lutaml/model/serialize/initialization.rb +825 -0
  439. data/lib/lutaml/model/serialize/model_import.rb +425 -0
  440. data/lib/lutaml/model/serialize/transformation_builder.rb +128 -0
  441. data/lib/lutaml/model/serialize/value_mapping.rb +173 -0
  442. data/lib/lutaml/model/serialize.rb +533 -0
  443. data/lib/lutaml/model/services/base.rb +13 -0
  444. data/lib/lutaml/model/services/logger.rb +57 -0
  445. data/lib/lutaml/model/services/rule_value_extractor.rb +95 -0
  446. data/lib/lutaml/model/services/transformer.rb +143 -0
  447. data/lib/lutaml/model/services/type/validator/number.rb +25 -0
  448. data/lib/lutaml/model/services/type/validator/string.rb +53 -0
  449. data/lib/lutaml/model/services/type/validator/symbol.rb +30 -0
  450. data/lib/lutaml/model/services/type/validator.rb +69 -0
  451. data/lib/lutaml/model/services/type.rb +9 -0
  452. data/lib/lutaml/model/services/validator.rb +143 -0
  453. data/lib/lutaml/model/services.rb +10 -0
  454. data/lib/lutaml/model/store.rb +239 -0
  455. data/lib/lutaml/model/toml.rb +40 -0
  456. data/lib/lutaml/model/transform/xml_transform.rb +5 -0
  457. data/lib/lutaml/model/transform.rb +229 -0
  458. data/lib/lutaml/model/transformation.rb +89 -0
  459. data/lib/lutaml/model/transformation_builder.rb +55 -0
  460. data/lib/lutaml/model/transformation_registry.rb +327 -0
  461. data/lib/lutaml/model/type/base64_binary.rb +58 -0
  462. data/lib/lutaml/model/type/boolean.rb +35 -0
  463. data/lib/lutaml/model/type/date.rb +75 -0
  464. data/lib/lutaml/model/type/date_time.rb +60 -0
  465. data/lib/lutaml/model/type/date_time_with_timezone.rb +28 -0
  466. data/lib/lutaml/model/type/date_with_timezone.rb +28 -0
  467. data/lib/lutaml/model/type/day_time_duration.rb +35 -0
  468. data/lib/lutaml/model/type/decimal.rb +64 -0
  469. data/lib/lutaml/model/type/duration.rb +82 -0
  470. data/lib/lutaml/model/type/email_address.rb +28 -0
  471. data/lib/lutaml/model/type/float.rb +33 -0
  472. data/lib/lutaml/model/type/hash.rb +74 -0
  473. data/lib/lutaml/model/type/hex_binary.rb +56 -0
  474. data/lib/lutaml/model/type/hostname.rb +30 -0
  475. data/lib/lutaml/model/type/integer.rb +62 -0
  476. data/lib/lutaml/model/type/ip_v4_address.rb +27 -0
  477. data/lib/lutaml/model/type/ip_v6_address.rb +47 -0
  478. data/lib/lutaml/model/type/metaschema_pattern.rb +34 -0
  479. data/lib/lutaml/model/type/non_negative_integer.rb +25 -0
  480. data/lib/lutaml/model/type/positive_integer.rb +25 -0
  481. data/lib/lutaml/model/type/qname.rb +85 -0
  482. data/lib/lutaml/model/type/reference.rb +76 -0
  483. data/lib/lutaml/model/type/string.rb +62 -0
  484. data/lib/lutaml/model/type/symbol.rb +67 -0
  485. data/lib/lutaml/model/type/time.rb +52 -0
  486. data/lib/lutaml/model/type/time_without_date.rb +50 -0
  487. data/lib/lutaml/model/type/token.rb +25 -0
  488. data/lib/lutaml/model/type/uninitialized_class_guard.rb +36 -0
  489. data/lib/lutaml/model/type/uri.rb +51 -0
  490. data/lib/lutaml/model/type/uri_reference.rb +29 -0
  491. data/lib/lutaml/model/type/uuid.rb +25 -0
  492. data/lib/lutaml/model/type/value.rb +364 -0
  493. data/lib/lutaml/model/type/year_month_duration.rb +29 -0
  494. data/lib/lutaml/model/type.rb +199 -0
  495. data/lib/lutaml/model/type_context.rb +294 -0
  496. data/lib/lutaml/model/type_registry.rb +165 -0
  497. data/lib/lutaml/model/type_resolver.rb +187 -0
  498. data/lib/lutaml/model/type_substitution.rb +117 -0
  499. data/lib/lutaml/model/uninitialized_class.rb +70 -0
  500. data/lib/lutaml/model/union.rb +363 -0
  501. data/lib/lutaml/model/utils.rb +352 -0
  502. data/lib/lutaml/model/validation/concerns/has_issues.rb +27 -0
  503. data/lib/lutaml/model/validation/context.rb +36 -0
  504. data/lib/lutaml/model/validation/issue.rb +62 -0
  505. data/lib/lutaml/model/validation/layer_result.rb +34 -0
  506. data/lib/lutaml/model/validation/profile.rb +66 -0
  507. data/lib/lutaml/model/validation/registry.rb +60 -0
  508. data/lib/lutaml/model/validation/remediation.rb +33 -0
  509. data/lib/lutaml/model/validation/remediation_result.rb +20 -0
  510. data/lib/lutaml/model/validation/report.rb +39 -0
  511. data/lib/lutaml/model/validation/rule.rb +59 -0
  512. data/lib/lutaml/model/validation.rb +137 -0
  513. data/lib/lutaml/model/validation_framework.rb +77 -0
  514. data/lib/lutaml/model/value_policy.rb +27 -0
  515. data/lib/lutaml/model/value_transformer.rb +25 -0
  516. data/lib/lutaml/model/version.rb +7 -0
  517. data/lib/lutaml/model/yaml.rb +15 -0
  518. data/lib/lutaml/model/yamls.rb +15 -0
  519. data/lib/lutaml/model.rb +309 -0
  520. data/lib/lutaml/rdf/context.rb +69 -0
  521. data/lib/lutaml/rdf/error.rb +7 -0
  522. data/lib/lutaml/rdf/iri.rb +44 -0
  523. data/lib/lutaml/rdf/language_tagged.rb +11 -0
  524. data/lib/lutaml/rdf/linked_data_transform.rb +249 -0
  525. data/lib/lutaml/rdf/literal.rb +62 -0
  526. data/lib/lutaml/rdf/mapping.rb +86 -0
  527. data/lib/lutaml/rdf/mapping_rule.rb +52 -0
  528. data/lib/lutaml/rdf/member_rule.rb +55 -0
  529. data/lib/lutaml/rdf/namespace.rb +58 -0
  530. data/lib/lutaml/rdf/namespace_set.rb +69 -0
  531. data/lib/lutaml/rdf/namespaces/dcterms_namespace.rb +12 -0
  532. data/lib/lutaml/rdf/namespaces/owl_namespace.rb +12 -0
  533. data/lib/lutaml/rdf/namespaces/rdf_namespace.rb +14 -0
  534. data/lib/lutaml/rdf/namespaces/rdfs_namespace.rb +12 -0
  535. data/lib/lutaml/rdf/namespaces/skos_namespace.rb +12 -0
  536. data/lib/lutaml/rdf/namespaces/xsd_namespace.rb +12 -0
  537. data/lib/lutaml/rdf/namespaces.rb +14 -0
  538. data/lib/lutaml/rdf/term_definition.rb +39 -0
  539. data/lib/lutaml/rdf/transform.rb +45 -0
  540. data/lib/lutaml/rdf.rb +22 -0
  541. data/lib/lutaml/toml/adapter/document.rb +10 -0
  542. data/lib/lutaml/toml/adapter/mapping.rb +26 -0
  543. data/lib/lutaml/toml/adapter/mapping_rule.rb +9 -0
  544. data/lib/lutaml/toml/adapter/teptris_adapter.rb +14 -0
  545. data/lib/lutaml/toml/adapter/toml_rb_adapter.rb +32 -0
  546. data/lib/lutaml/toml/adapter/tomlib_adapter.rb +48 -0
  547. data/lib/lutaml/toml/adapter/transform.rb +9 -0
  548. data/lib/lutaml/toml/adapter.rb +20 -0
  549. data/lib/lutaml/toml/format.rb +48 -0
  550. data/lib/lutaml/toml/type/serializers.rb +71 -0
  551. data/lib/lutaml/toml.rb +7 -0
  552. data/lib/lutaml/turtle/adapter.rb +35 -0
  553. data/lib/lutaml/turtle/mapping.rb +7 -0
  554. data/lib/lutaml/turtle/transform.rb +250 -0
  555. data/lib/lutaml/turtle.rb +22 -0
  556. data/lib/lutaml/version.rb +1 -1
  557. data/lib/lutaml/xml/adapter/adapter_helpers.rb +108 -0
  558. data/lib/lutaml/xml/adapter/base_adapter.rb +249 -0
  559. data/lib/lutaml/xml/adapter/leptris_adapter.rb +16 -0
  560. data/lib/lutaml/xml/adapter/namespace_data.rb +56 -0
  561. data/lib/lutaml/xml/adapter/namespace_uri_collector.rb +71 -0
  562. data/lib/lutaml/xml/adapter/nokogiri_adapter.rb +16 -0
  563. data/lib/lutaml/xml/adapter/oga_adapter.rb +20 -0
  564. data/lib/lutaml/xml/adapter/ox_adapter.rb +16 -0
  565. data/lib/lutaml/xml/adapter/plan_based_builder.rb +944 -0
  566. data/lib/lutaml/xml/adapter/rexml_adapter.rb +25 -0
  567. data/lib/lutaml/xml/adapter/xml_parser.rb +89 -0
  568. data/lib/lutaml/xml/adapter/xml_serializer.rb +334 -0
  569. data/lib/lutaml/xml/adapter.rb +24 -0
  570. data/lib/lutaml/xml/adapter_element.rb +339 -0
  571. data/lib/lutaml/xml/adapter_loader.rb +56 -0
  572. data/lib/lutaml/xml/attribute_namespace_resolver.rb +139 -0
  573. data/lib/lutaml/xml/blank_namespace.rb +51 -0
  574. data/lib/lutaml/xml/blank_namespace_handler.rb +50 -0
  575. data/lib/lutaml/xml/builder/base.rb +258 -0
  576. data/lib/lutaml/xml/builder/leptris.rb +13 -0
  577. data/lib/lutaml/xml/builder/nokogiri.rb +13 -0
  578. data/lib/lutaml/xml/builder/oga.rb +13 -0
  579. data/lib/lutaml/xml/builder/ox.rb +13 -0
  580. data/lib/lutaml/xml/builder/rexml.rb +13 -0
  581. data/lib/lutaml/xml/builder.rb +18 -0
  582. data/lib/lutaml/xml/configurable.rb +215 -0
  583. data/lib/lutaml/xml/data_model.rb +295 -0
  584. data/lib/lutaml/xml/decisions/decision.rb +120 -0
  585. data/lib/lutaml/xml/decisions/decision_context.rb +225 -0
  586. data/lib/lutaml/xml/decisions/decision_engine.rb +67 -0
  587. data/lib/lutaml/xml/decisions/decision_rule.rb +54 -0
  588. data/lib/lutaml/xml/decisions/element_prefix_resolver.rb +85 -0
  589. data/lib/lutaml/xml/decisions/rules/attribute_usage_rule.rb +37 -0
  590. data/lib/lutaml/xml/decisions/rules/default_preference_rule.rb +62 -0
  591. data/lib/lutaml/xml/decisions/rules/element_form_default_rule.rb +66 -0
  592. data/lib/lutaml/xml/decisions/rules/element_form_default_unqualified_rule.rb +73 -0
  593. data/lib/lutaml/xml/decisions/rules/element_form_option_rule.rb +83 -0
  594. data/lib/lutaml/xml/decisions/rules/explicit_option_rule.rb +57 -0
  595. data/lib/lutaml/xml/decisions/rules/format_preservation_rule.rb +74 -0
  596. data/lib/lutaml/xml/decisions/rules/hoisted_on_parent_rule.rb +60 -0
  597. data/lib/lutaml/xml/decisions/rules/inherit_from_parent_rule.rb +52 -0
  598. data/lib/lutaml/xml/decisions/rules/inherit_parent_prefix_rule.rb +69 -0
  599. data/lib/lutaml/xml/decisions/rules/namespace_scope_rule.rb +54 -0
  600. data/lib/lutaml/xml/decisions/rules/reuse_parent_prefix_rule.rb +78 -0
  601. data/lib/lutaml/xml/decisions/rules/used_prefix_rule.rb +70 -0
  602. data/lib/lutaml/xml/decisions/rules.rb +39 -0
  603. data/lib/lutaml/xml/decisions.rb +15 -0
  604. data/lib/lutaml/xml/declaration_handler.rb +115 -0
  605. data/lib/lutaml/xml/declaration_plan/attribute_node.rb +81 -0
  606. data/lib/lutaml/xml/declaration_plan/element_node.rb +101 -0
  607. data/lib/lutaml/xml/declaration_plan.rb +480 -0
  608. data/lib/lutaml/xml/declaration_plan_query.rb +105 -0
  609. data/lib/lutaml/xml/declaration_planner.rb +1914 -0
  610. data/lib/lutaml/xml/doctype_extractor.rb +51 -0
  611. data/lib/lutaml/xml/document.rb +385 -0
  612. data/lib/lutaml/xml/element.rb +108 -0
  613. data/lib/lutaml/xml/element_prefix_resolver.rb +50 -0
  614. data/lib/lutaml/xml/encoding_normalizer.rb +54 -0
  615. data/lib/lutaml/xml/error/invalid_namespace_error.rb +46 -0
  616. data/lib/lutaml/xml/error/invalid_xsd_type_error.rb +43 -0
  617. data/lib/lutaml/xml/error/namespace_mismatch_error.rb +53 -0
  618. data/lib/lutaml/xml/error/schema_validation_error.rb +25 -0
  619. data/lib/lutaml/xml/error/xml_configuration_error.rb +17 -0
  620. data/lib/lutaml/xml/error/xml_error.rb +21 -0
  621. data/lib/lutaml/xml/format.rb +364 -0
  622. data/lib/lutaml/xml/format_chooser.rb +214 -0
  623. data/lib/lutaml/xml/hoisting_algorithm.rb +234 -0
  624. data/lib/lutaml/xml/html_entities.rb +290 -0
  625. data/lib/lutaml/xml/leptris/element.rb +34 -0
  626. data/lib/lutaml/xml/leptris/native_emission.rb +295 -0
  627. data/lib/lutaml/xml/leptris/plan_compiler.rb +652 -0
  628. data/lib/lutaml/xml/leptris/plan_hydrator.rb +827 -0
  629. data/lib/lutaml/xml/leptris/plan_order.rb +72 -0
  630. data/lib/lutaml/xml/leptris/plan_serializer.rb +711 -0
  631. data/lib/lutaml/xml/leptris/plan_walk.rb +36 -0
  632. data/lib/lutaml/xml/leptris.rb +48 -0
  633. data/lib/lutaml/xml/listener.rb +33 -0
  634. data/lib/lutaml/xml/mapping.rb +1746 -0
  635. data/lib/lutaml/xml/mapping_rule.rb +688 -0
  636. data/lib/lutaml/xml/model_transform.rb +1824 -0
  637. data/lib/lutaml/xml/namespace.rb +445 -0
  638. data/lib/lutaml/xml/namespace_class_registry.rb +144 -0
  639. data/lib/lutaml/xml/namespace_collector.rb +649 -0
  640. data/lib/lutaml/xml/namespace_declaration.rb +202 -0
  641. data/lib/lutaml/xml/namespace_declaration_builder.rb +67 -0
  642. data/lib/lutaml/xml/namespace_declaration_data.rb +179 -0
  643. data/lib/lutaml/xml/namespace_inheritance_resolver.rb +142 -0
  644. data/lib/lutaml/xml/namespace_inheritance_strategy.rb +26 -0
  645. data/lib/lutaml/xml/namespace_needs.rb +255 -0
  646. data/lib/lutaml/xml/namespace_resolution_strategy.rb +230 -0
  647. data/lib/lutaml/xml/namespace_resolver.rb +219 -0
  648. data/lib/lutaml/xml/namespace_scope_config.rb +110 -0
  649. data/lib/lutaml/xml/namespace_type_resolver.rb +135 -0
  650. data/lib/lutaml/xml/namespace_usage.rb +121 -0
  651. data/lib/lutaml/xml/nested_collection_attribute.rb +95 -0
  652. data/lib/lutaml/xml/nokogiri/element.rb +34 -0
  653. data/lib/lutaml/xml/nokogiri.rb +10 -0
  654. data/lib/lutaml/xml/oga/element.rb +15 -0
  655. data/lib/lutaml/xml/oga.rb +10 -0
  656. data/lib/lutaml/xml/ox/element.rb +15 -0
  657. data/lib/lutaml/xml/ox.rb +10 -0
  658. data/lib/lutaml/xml/parse_session.rb +139 -0
  659. data/lib/lutaml/xml/parsed_namespace_declaration.rb +129 -0
  660. data/lib/lutaml/xml/parsed_namespace_set.rb +149 -0
  661. data/lib/lutaml/xml/polymorphic_value_handler.rb +41 -0
  662. data/lib/lutaml/xml/qualified_inheritance_strategy.rb +27 -0
  663. data/lib/lutaml/xml/rexml/element.rb +15 -0
  664. data/lib/lutaml/xml/rexml.rb +10 -0
  665. data/lib/lutaml/xml/schema/builder/nokogiri.rb +41 -0
  666. data/lib/lutaml/xml/schema/builder/oga.rb +92 -0
  667. data/lib/lutaml/xml/schema/builder.rb +59 -0
  668. data/lib/lutaml/xml/schema/builtin_types.rb +112 -0
  669. data/lib/lutaml/xml/schema/relaxng_schema.rb +83 -0
  670. data/lib/lutaml/xml/schema/xsd/all.rb +31 -0
  671. data/lib/lutaml/xml/schema/xsd/annotation.rb +31 -0
  672. data/lib/lutaml/xml/schema/xsd/any.rb +33 -0
  673. data/lib/lutaml/xml/schema/xsd/any_attribute.rb +29 -0
  674. data/lib/lutaml/xml/schema/xsd/appinfo.rb +25 -0
  675. data/lib/lutaml/xml/schema/xsd/attribute.rb +78 -0
  676. data/lib/lutaml/xml/schema/xsd/attribute_group.rb +89 -0
  677. data/lib/lutaml/xml/schema/xsd/base.rb +270 -0
  678. data/lib/lutaml/xml/schema/xsd/choice.rb +68 -0
  679. data/lib/lutaml/xml/schema/xsd/complex_content.rb +39 -0
  680. data/lib/lutaml/xml/schema/xsd/complex_type.rb +159 -0
  681. data/lib/lutaml/xml/schema/xsd/documentation.rb +26 -0
  682. data/lib/lutaml/xml/schema/xsd/element.rb +117 -0
  683. data/lib/lutaml/xml/schema/xsd/enumeration.rb +25 -0
  684. data/lib/lutaml/xml/schema/xsd/errors/enhanced_error.rb +142 -0
  685. data/lib/lutaml/xml/schema/xsd/errors/error_context.rb +67 -0
  686. data/lib/lutaml/xml/schema/xsd/errors/message_builder.rb +103 -0
  687. data/lib/lutaml/xml/schema/xsd/errors/suggestion.rb +67 -0
  688. data/lib/lutaml/xml/schema/xsd/errors/troubleshooters/namespace_troubleshooter.rb +96 -0
  689. data/lib/lutaml/xml/schema/xsd/errors/troubleshooters/troubleshooting_handler.rb +70 -0
  690. data/lib/lutaml/xml/schema/xsd/errors.rb +148 -0
  691. data/lib/lutaml/xml/schema/xsd/extension_complex_content.rb +63 -0
  692. data/lib/lutaml/xml/schema/xsd/extension_simple_content.rb +48 -0
  693. data/lib/lutaml/xml/schema/xsd/field.rb +25 -0
  694. data/lib/lutaml/xml/schema/xsd/file_validation_result.rb +55 -0
  695. data/lib/lutaml/xml/schema/xsd/fraction_digits.rb +29 -0
  696. data/lib/lutaml/xml/schema/xsd/glob.rb +105 -0
  697. data/lib/lutaml/xml/schema/xsd/group.rb +79 -0
  698. data/lib/lutaml/xml/schema/xsd/import.rb +33 -0
  699. data/lib/lutaml/xml/schema/xsd/include.rb +31 -0
  700. data/lib/lutaml/xml/schema/xsd/key.rb +32 -0
  701. data/lib/lutaml/xml/schema/xsd/keyref.rb +34 -0
  702. data/lib/lutaml/xml/schema/xsd/length.rb +27 -0
  703. data/lib/lutaml/xml/schema/xsd/list.rb +29 -0
  704. data/lib/lutaml/xml/schema/xsd/max_exclusive.rb +25 -0
  705. data/lib/lutaml/xml/schema/xsd/max_inclusive.rb +23 -0
  706. data/lib/lutaml/xml/schema/xsd/max_length.rb +25 -0
  707. data/lib/lutaml/xml/schema/xsd/min_exclusive.rb +25 -0
  708. data/lib/lutaml/xml/schema/xsd/min_inclusive.rb +23 -0
  709. data/lib/lutaml/xml/schema/xsd/min_length.rb +25 -0
  710. data/lib/lutaml/xml/schema/xsd/namespace_mapping.rb +37 -0
  711. data/lib/lutaml/xml/schema/xsd/namespace_uri_remapping.rb +79 -0
  712. data/lib/lutaml/xml/schema/xsd/notation.rb +31 -0
  713. data/lib/lutaml/xml/schema/xsd/pattern.rb +25 -0
  714. data/lib/lutaml/xml/schema/xsd/redefine.rb +35 -0
  715. data/lib/lutaml/xml/schema/xsd/restriction_complex_content.rb +56 -0
  716. data/lib/lutaml/xml/schema/xsd/restriction_simple_content.rb +84 -0
  717. data/lib/lutaml/xml/schema/xsd/restriction_simple_type.rb +64 -0
  718. data/lib/lutaml/xml/schema/xsd/schema.rb +379 -0
  719. data/lib/lutaml/xml/schema/xsd/schema_file_validation_results.rb +55 -0
  720. data/lib/lutaml/xml/schema/xsd/schema_location_mapping.rb +74 -0
  721. data/lib/lutaml/xml/schema/xsd/schema_name_resolver.rb +32 -0
  722. data/lib/lutaml/xml/schema/xsd/schema_path.rb +207 -0
  723. data/lib/lutaml/xml/schema/xsd/schema_validator.rb +259 -0
  724. data/lib/lutaml/xml/schema/xsd/selector.rb +27 -0
  725. data/lib/lutaml/xml/schema/xsd/sequence.rb +68 -0
  726. data/lib/lutaml/xml/schema/xsd/serialized_schema.rb +185 -0
  727. data/lib/lutaml/xml/schema/xsd/simple_content.rb +61 -0
  728. data/lib/lutaml/xml/schema/xsd/simple_type.rb +37 -0
  729. data/lib/lutaml/xml/schema/xsd/total_digits.rb +29 -0
  730. data/lib/lutaml/xml/schema/xsd/type_index_entry.rb +40 -0
  731. data/lib/lutaml/xml/schema/xsd/type_resolution_result.rb +112 -0
  732. data/lib/lutaml/xml/schema/xsd/union.rb +30 -0
  733. data/lib/lutaml/xml/schema/xsd/unique.rb +31 -0
  734. data/lib/lutaml/xml/schema/xsd/validation_error.rb +48 -0
  735. data/lib/lutaml/xml/schema/xsd/validation_result.rb +86 -0
  736. data/lib/lutaml/xml/schema/xsd/version.rb +11 -0
  737. data/lib/lutaml/xml/schema/xsd/white_space.rb +27 -0
  738. data/lib/lutaml/xml/schema/xsd.rb +164 -0
  739. data/lib/lutaml/xml/schema/xsd_namespace.rb +29 -0
  740. data/lib/lutaml/xml/schema/xsd_schema.rb +1002 -0
  741. data/lib/lutaml/xml/schema.rb +16 -0
  742. data/lib/lutaml/xml/schema_location.rb +155 -0
  743. data/lib/lutaml/xml/serialization/collection_ext.rb +61 -0
  744. data/lib/lutaml/xml/serialization/format_conversion.rb +433 -0
  745. data/lib/lutaml/xml/serialization/instance_methods.rb +323 -0
  746. data/lib/lutaml/xml/serialization/model_import_ext.rb +40 -0
  747. data/lib/lutaml/xml/serialization.rb +15 -0
  748. data/lib/lutaml/xml/shared_dsl.rb +119 -0
  749. data/lib/lutaml/xml/transform.rb +6 -0
  750. data/lib/lutaml/xml/transformation/custom_method_wrapper.rb +258 -0
  751. data/lib/lutaml/xml/transformation/element_builder.rb +697 -0
  752. data/lib/lutaml/xml/transformation/order_reconciler.rb +282 -0
  753. data/lib/lutaml/xml/transformation/ordered_applier.rb +529 -0
  754. data/lib/lutaml/xml/transformation/rule_applier.rb +403 -0
  755. data/lib/lutaml/xml/transformation/rule_compiler.rb +556 -0
  756. data/lib/lutaml/xml/transformation/skip_logic.rb +70 -0
  757. data/lib/lutaml/xml/transformation/value_serializer.rb +137 -0
  758. data/lib/lutaml/xml/transformation.rb +454 -0
  759. data/lib/lutaml/xml/transformation_builder.rb +28 -0
  760. data/lib/lutaml/xml/transformation_support.rb +15 -0
  761. data/lib/lutaml/xml/type/configurable.rb +153 -0
  762. data/lib/lutaml/xml/type/serializers.rb +105 -0
  763. data/lib/lutaml/xml/type/value_xml_mapping.rb +94 -0
  764. data/lib/lutaml/xml/type_namespace/collector.rb +101 -0
  765. data/lib/lutaml/xml/type_namespace/declaration.rb +61 -0
  766. data/lib/lutaml/xml/type_namespace/planner.rb +121 -0
  767. data/lib/lutaml/xml/type_namespace/reference.rb +71 -0
  768. data/lib/lutaml/xml/type_namespace/resolver.rb +43 -0
  769. data/lib/lutaml/xml/type_namespace.rb +13 -0
  770. data/lib/lutaml/xml/type_namespace_resolver.rb +76 -0
  771. data/lib/lutaml/xml/unqualified_inheritance_strategy.rb +34 -0
  772. data/lib/lutaml/xml/w3c/registration.rb +66 -0
  773. data/lib/lutaml/xml/w3c.rb +398 -0
  774. data/lib/lutaml/xml/xml_attribute.rb +58 -0
  775. data/lib/lutaml/xml/xml_element.rb +498 -0
  776. data/lib/lutaml/xml/xml_namespace.rb +72 -0
  777. data/lib/lutaml/xml/xml_orderable.rb +17 -0
  778. data/lib/lutaml/xml/xsd_validator.rb +66 -0
  779. data/lib/lutaml/xml.rb +7 -0
  780. data/lib/lutaml/yaml/adapter/document.rb +12 -0
  781. data/lib/lutaml/yaml/adapter/mapping.rb +17 -0
  782. data/lib/lutaml/yaml/adapter/mapping_rule.rb +9 -0
  783. data/lib/lutaml/yaml/adapter/standard_adapter.rb +35 -0
  784. data/lib/lutaml/yaml/adapter/transform.rb +9 -0
  785. data/lib/lutaml/yaml/adapter/yeptris_adapter.rb +107 -0
  786. data/lib/lutaml/yaml/adapter.rb +18 -0
  787. data/lib/lutaml/yaml/format.rb +31 -0
  788. data/lib/lutaml/yaml/schema/yaml_schema.rb +65 -0
  789. data/lib/lutaml/yaml/schema.rb +9 -0
  790. data/lib/lutaml/yaml/type/serializers.rb +60 -0
  791. data/lib/lutaml/yaml.rb +7 -0
  792. data/lib/lutaml/yamlld/adapter.rb +20 -0
  793. data/lib/lutaml/yamlld.rb +25 -0
  794. data/lib/lutaml/yamls/adapter/document.rb +14 -0
  795. data/lib/lutaml/yamls/adapter/mapping.rb +30 -0
  796. data/lib/lutaml/yamls/adapter/mapping_rule.rb +9 -0
  797. data/lib/lutaml/yamls/adapter/standard_adapter.rb +56 -0
  798. data/lib/lutaml/yamls/adapter/transform.rb +124 -0
  799. data/lib/lutaml/yamls/adapter/yamls_sequence.rb +20 -0
  800. data/lib/lutaml/yamls/adapter/yamls_sequence_rule.rb +48 -0
  801. data/lib/lutaml/yamls/adapter.rb +15 -0
  802. data/lib/lutaml/yamls/format.rb +22 -0
  803. data/lib/lutaml/yamls.rb +7 -0
  804. data/lib/lutaml.rb +11 -5
  805. data/lib/tasks/benchmark_runner.rb +161 -0
  806. data/lib/tasks/memory_profile.rb +176 -0
  807. data/lib/tasks/performance.rake +80 -0
  808. data/lib/tasks/performance_benchmark.rb +499 -0
  809. data/lib/tasks/performance_comparator.rb +130 -0
  810. data/lib/tasks/performance_helpers.rb +149 -0
  811. data/lib/tasks/performance_probe.rake +33 -0
  812. data/lib/tasks/performance_probe.rb +106 -0
  813. data/lib/tasks/performance_probe_plan_walk.rb +58 -0
  814. data/lib/tasks/performance_probe_xml.rb +54 -0
  815. data/lib/tasks/xml_compiler_benchmark.rb +226 -0
  816. data/lib/tasks/xml_optimization_benchmark.rb +178 -0
  817. data/lutaml.gemspec +16 -8
  818. metadata +902 -83
  819. data/.github/workflows/docs.yml +0 -86
  820. data/.github/workflows/links.yml +0 -113
  821. data/.github/workflows/rake.yml +0 -23
  822. data/.github/workflows/release.yml +0 -37
  823. data/.gitignore +0 -29
  824. data/CLAUDE.md +0 -62
  825. data/docs/.github/workflows/docs.yml +0 -66
  826. data/docs/.github/workflows/links.yml +0 -78
  827. data/docs/CONTINUATION_PLAN.md +0 -168
  828. data/docs/Gemfile +0 -13
  829. data/docs/MIGRATION_GUIDE.md +0 -202
  830. data/docs/README.md +0 -252
  831. data/docs/REFACTOR_PLAN.md +0 -214
  832. data/docs/_config.yml +0 -144
  833. data/docs/_guides/cli-usage.adoc +0 -43
  834. data/docs/_guides/diagram-generation.adoc +0 -316
  835. data/docs/_guides/index.adoc +0 -136
  836. data/docs/_guides/parsing/express-parsing.adoc +0 -42
  837. data/docs/_guides/parsing/index.adoc +0 -78
  838. data/docs/_guides/parsing/qea-parsing.adoc +0 -47
  839. data/docs/_guides/parsing/xmi-parsing.adoc +0 -40
  840. data/docs/_guides/repository-management.adoc +0 -44
  841. data/docs/_guides/sysml-modeling.adoc +0 -37
  842. data/docs/_guides/uml-modeling.adoc +0 -115
  843. data/docs/_pages/concepts/diagram-generation.adoc +0 -337
  844. data/docs/_pages/concepts/lur-format.adoc +0 -711
  845. data/docs/_pages/concepts/qea-parsing.adoc +0 -418
  846. data/docs/_pages/concepts/uml-models.adoc +0 -43
  847. data/docs/_pages/core/architecture.adoc +0 -329
  848. data/docs/_pages/core/installation.adoc +0 -321
  849. data/docs/_pages/core/overview.adoc +0 -197
  850. data/docs/_pages/index.adoc +0 -49
  851. data/docs/_pages/uml-syntax.adoc +0 -1011
  852. data/docs/_references/api/parsers.adoc +0 -61
  853. data/docs/_references/api/presenters.adoc +0 -43
  854. data/docs/_references/api/repository.adoc +0 -67
  855. data/docs/_references/cli/commands.adoc +0 -72
  856. data/docs/_references/configuration/diagram-styles.adoc +0 -716
  857. data/docs/_references/configuration/index.adoc +0 -53
  858. data/docs/_references/configuration/package-metadata.adoc +0 -416
  859. data/docs/_references/formats/index.adoc +0 -43
  860. data/docs/_references/formats/lur-format.adoc +0 -39
  861. data/docs/_references/formats/lutaml-syntax.adoc +0 -379
  862. data/docs/_references/formats/qea-structure.adoc +0 -1364
  863. data/docs/_references/index.adoc +0 -198
  864. data/docs/_tutorials/documentation-site.adoc +0 -47
  865. data/docs/_tutorials/first-lur-package.adoc +0 -45
  866. data/docs/_tutorials/generating-diagrams.adoc +0 -42
  867. data/docs/_tutorials/getting-started.adoc +0 -45
  868. data/docs/_tutorials/index.adoc +0 -100
  869. data/docs/_tutorials/querying-models.adoc +0 -44
  870. data/docs/examples/build_package.rb +0 -12
  871. data/docs/examples/build_site.rb +0 -12
  872. data/docs/examples/city_model.rb +0 -21
  873. data/docs/examples/present_class.rb +0 -10
  874. data/docs/examples/query_model.rb +0 -12
  875. data/docs/examples/render_diagram.rb +0 -11
  876. data/docs/index.adoc +0 -64
  877. data/docs/lychee.toml +0 -50
  878. data/lib/lutaml/express/parsers/exp.rb +0 -28
  879. data/lib/lutaml/express.rb +0 -10
  880. data/scripts/check-site-urls.rb +0 -54
  881. data/scripts/check-vendor-link.py +0 -64
@@ -0,0 +1,944 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Lutaml
4
+ module Xml
5
+ module Adapter
6
+ # Builds XML elements from model instances using namespace declaration plans.
7
+ #
8
+ # Handles both ordered and unordered child serialization, nested model
9
+ # elements, simple values, and namespace resolution. This module is the
10
+ # core of model-to-XML conversion when a DeclarationPlan drives the output.
11
+ module PlanBasedBuilder
12
+ # Build element using prepared namespace declaration plan
13
+ #
14
+ # @param xml [Builder] the XML builder
15
+ # @param element [Object] the model instance
16
+ # @param plan [DeclarationPlan] the declaration plan from DeclarationPlanner
17
+ # @param options [Hash] serialization options
18
+ def build_element_with_plan(xml, element, plan, options = {})
19
+ plan ||= DeclarationPlan.empty
20
+ mapper_class = options[:mapper_class] || element.class
21
+
22
+ unless mapper_class.is_a?(Class) &&
23
+ mapper_class.include?(Lutaml::Model::Serialize)
24
+ tag_name = options[:tag_name] || "element"
25
+ xml.create_and_add_element(tag_name) do |inner_xml|
26
+ inner_xml.text(text_content_for_xml(element))
27
+ end
28
+ return xml
29
+ end
30
+
31
+ xml_mapping = mapper_class.mappings_for(:xml)
32
+ return xml unless xml_mapping
33
+
34
+ # TYPE-ONLY MODELS: No element wrapper, serialize children directly
35
+ # BUT if we have a tag_name in options, that means parent wants a wrapper
36
+ if xml_mapping.no_element?
37
+ build_type_only_element(xml, element, xml_mapping, plan, options,
38
+ mapper_class)
39
+ return xml
40
+ end
41
+
42
+ # Use xmlns declarations from plan
43
+ attributes = {}
44
+
45
+ # Apply namespace declarations from plan using extracted module
46
+ attributes.merge!(NamespaceDeclarationBuilder.build_xmlns_attributes(plan))
47
+
48
+ # Collect attribute custom methods to call after element creation
49
+ attribute_custom_methods = []
50
+
51
+ # Add regular attributes (non-xmlns)
52
+ xml_mapping.attributes.each do |attribute_rule|
53
+ next if options[:except]&.include?(attribute_rule.to)
54
+
55
+ # Collect custom methods for later execution (after element is created)
56
+ if attribute_rule.custom_methods[:to]
57
+ attribute_custom_methods << attribute_rule
58
+ next
59
+ end
60
+
61
+ mapping_rule_name = if attribute_rule.multiple_mappings?
62
+ attribute_rule.name.first
63
+ else
64
+ attribute_rule.name
65
+ end
66
+
67
+ attr = attribute_definition_for(element, attribute_rule,
68
+ mapper_class: mapper_class)
69
+ value = attribute_rule.to_value_for(element)
70
+
71
+ # Handle as_list and delimiter BEFORE serialization for array values
72
+ # These features convert arrays to delimited strings before serialization
73
+ if value.is_a?(Array)
74
+ if attribute_rule.as_list && attribute_rule.as_list[:export]
75
+ value = attribute_rule.as_list[:export].call(value)
76
+ elsif attribute_rule.delimiter
77
+ value = value.join(attribute_rule.delimiter)
78
+ end
79
+ end
80
+
81
+ value = attr.serialize(value, :xml, register) if attr
82
+ value = ExportTransformer.call(value, attribute_rule, attr,
83
+ format: :xml)
84
+
85
+ if render_element?(attribute_rule, element, value)
86
+ # Resolve attribute namespace using extracted module
87
+ ns_info = AttributeNamespaceResolver.resolve(
88
+ rule: attribute_rule,
89
+ attribute: attr,
90
+ plan: plan,
91
+ mapper_class: mapper_class,
92
+ register: register,
93
+ )
94
+
95
+ # Build qualified attribute name based on W3C semantics
96
+ attr_name = AttributeNamespaceResolver.build_qualified_name(
97
+ ns_info,
98
+ mapping_rule_name,
99
+ attribute_rule,
100
+ )
101
+ attributes[attr_name] = value ? value.to_s : value
102
+
103
+ # Add local xmlns declaration if needed
104
+ if ns_info[:needs_local_declaration]
105
+ attributes[ns_info[:local_xmlns_attr]] =
106
+ ns_info[:local_xmlns_uri]
107
+ end
108
+ end
109
+ end
110
+
111
+ # Add schema_location attribute from ElementNode if present
112
+ attributes.merge!(plan.root_node.schema_location_attr) if plan&.root_node&.schema_location_attr
113
+
114
+ # Determine prefix from plan using extracted module
115
+ prefix_info = ElementPrefixResolver.resolve(mapping: xml_mapping,
116
+ plan: plan)
117
+ prefix = prefix_info[:prefix]
118
+ ns_decl = if xml_mapping.namespace_class
119
+ plan.namespace_for_class(xml_mapping.namespace_class)
120
+ end
121
+
122
+ # Check if element's own namespace needs local declaration (out of scope)
123
+ if ns_decl&.local_on_use?
124
+ xmlns_attr = prefix ? "xmlns:#{prefix}" : "xmlns"
125
+ attributes[xmlns_attr] = ns_decl.uri
126
+ end
127
+
128
+ # W3C COMPLIANCE: Detect if element needs xmlns="" using extracted module
129
+ if BlankNamespaceHandler.needs_xmlns_blank?(mapping: xml_mapping,
130
+ options: options)
131
+ attributes["xmlns"] = ""
132
+ end
133
+
134
+ # Native type inheritance fix: handle local_on_use xmlns="" even if parents uses default format
135
+ xmlns_prefix = nil
136
+ xmlns_ns = nil
137
+ if xml_mapping&.namespace_class && plan
138
+ xmlns_ns = plan.namespace_for_class(xml_mapping.namespace_class)
139
+ xmlns_prefix = xmlns_ns&.prefix
140
+ end
141
+ if xmlns_ns&.local_on_use? && !xml_mapping.namespace_uri
142
+ attributes["xmlns:#{xmlns_prefix}"] =
143
+ xmlns_ns&.uri || xml_mapping.namespace_uri
144
+ end
145
+
146
+ tag_name = options[:tag_name] || xml_mapping.root_element
147
+ return if options[:except]&.include?(tag_name)
148
+
149
+ # Track if THIS element uses default namespace format
150
+ # Children will need this info to know if they should add xmlns=""
151
+ this_element_uses_default_ns = xml_mapping.namespace_class &&
152
+ plan.namespace_for_class(xml_mapping.namespace_class)&.default_format?
153
+
154
+ # Get element_form_default from this element's namespace for children
155
+ parent_element_form_default = xml_mapping.namespace_class&.element_form_default
156
+
157
+ xml.create_and_add_element(tag_name, attributes: attributes.compact,
158
+ prefix: prefix) do |inner_xml|
159
+ # Call attribute custom methods now that element is created
160
+ attribute_custom_methods.each do |attribute_rule|
161
+ mapper_class.new.public_send(attribute_rule.custom_methods[:to],
162
+ element, inner_xml.parent, inner_xml)
163
+ end
164
+
165
+ if ordered?(element, options.merge(mapper_class: mapper_class))
166
+ build_ordered_element_with_plan(inner_xml, element, plan,
167
+ options.merge(
168
+ mapper_class: mapper_class,
169
+ parent_prefix: prefix,
170
+ parent_uses_default_ns: this_element_uses_default_ns,
171
+ parent_element_form_default: parent_element_form_default,
172
+ parent_ns_decl: ns_decl,
173
+ ))
174
+ else
175
+ build_unordered_children_with_plan(inner_xml, element, plan,
176
+ options.merge(
177
+ mapper_class: mapper_class,
178
+ parent_prefix: prefix,
179
+ parent_uses_default_ns: this_element_uses_default_ns,
180
+ parent_element_form_default: parent_element_form_default,
181
+ parent_ns_decl: ns_decl,
182
+ ))
183
+ end
184
+ end
185
+ end
186
+
187
+ # Build XML from XmlDataModel::XmlElement structure
188
+ #
189
+ # @param xml [Builder] XML builder
190
+ # @param element [XmlDataModel::XmlElement] element to build
191
+ # @param parent_uses_default_ns [Boolean] parent uses default namespace format
192
+ # @param parent_element_form_default [Symbol] parent's element_form_default
193
+ # @param parent_namespace_class [Class] parent's namespace class
194
+ # @param plan [DeclarationPlan, nil] optional declaration plan for xmlns=""
195
+ # @param xml_mapping [Xml::Mapping] optional mapping for namespace resolution
196
+ def build_xml_element(xml, element, parent_uses_default_ns: false,
197
+ parent_element_form_default: nil, parent_namespace_class: nil, plan: nil, xml_mapping: nil)
198
+ # Prepare attributes hash
199
+ attributes = {}
200
+
201
+ # Get element's namespace class
202
+ element_ns_class = element.namespace_class
203
+ attribute_form_default = element_ns_class&.attribute_form_default || :unqualified
204
+ element_prefix = element_ns_class&.prefix_default
205
+
206
+ # Get element_form_default for children
207
+ this_element_form_default = element_ns_class&.element_form_default || :unqualified
208
+
209
+ # Add regular attributes
210
+ element.attributes.each do |attr|
211
+ # Determine attribute name with namespace consideration
212
+ attr_name = if attr.namespace_class
213
+ # Check if attribute is in SAME namespace as element
214
+ if attr.namespace_class == element_ns_class && attribute_form_default == :unqualified
215
+ # Same namespace + unqualified -> NO prefix (W3C rule)
216
+ attr.name
217
+ else
218
+ # Different namespace OR qualified -> use prefix
219
+ attr_prefix = attr.namespace_class.prefix_default
220
+ attr_prefix ? "#{attr_prefix}:#{attr.name}" : attr.name
221
+ end
222
+ elsif attribute_form_default == :qualified && element_prefix
223
+ # Attribute inherits element's namespace when qualified
224
+ "#{element_prefix}:#{attr.name}"
225
+ else
226
+ # Unqualified attribute
227
+ attr.name
228
+ end
229
+ # Ensure attribute value is a string
230
+ attributes[attr_name] = attr.value.to_s
231
+ end
232
+
233
+ # Determine element name with namespace prefix
234
+ tag_name = element.name
235
+
236
+ # Priority 2.5: Child namespace different from parent's default namespace
237
+ # MUST use prefix format to distinguish from parent
238
+ child_needs_prefix = if element_ns_class && parent_namespace_class &&
239
+ element_ns_class != parent_namespace_class && parent_uses_default_ns
240
+ element_prefix # Use child's prefix
241
+ end
242
+
243
+ # FIX: Read prefix from plan if available, otherwise use fallback logic
244
+ prefix = if child_needs_prefix
245
+ # Priority 2.5 takes precedence
246
+ child_needs_prefix
247
+ elsif plan && element_ns_class
248
+ # Read format decision from DeclarationPlan
249
+ ns_info = ElementPrefixResolver.resolve(
250
+ mapping: xml_mapping,
251
+ plan: plan,
252
+ )
253
+ ns_info[:prefix]
254
+ elsif element_ns_class && element_prefix
255
+ # Fallback: Element has explicit prefix_default - use prefix format
256
+ element_prefix
257
+ end
258
+
259
+ # Track if THIS element uses default namespace format for children
260
+ this_element_uses_default_ns = false
261
+
262
+ # Add namespace declaration if element has namespace
263
+ if element.namespace_class
264
+ ns_uri = element.namespace_class.uri
265
+
266
+ # Check if namespace is already declared by parent (hoisting optimization)
267
+ # This works for BOTH default and prefix format parents
268
+ ns_already_declared = parent_namespace_class && parent_namespace_class.uri == ns_uri
269
+
270
+ if prefix && !ns_already_declared
271
+ attributes["xmlns:#{prefix}"] = ns_uri
272
+ # W3C Compliance: xmlns="" only needed for blank namespace children
273
+ # Prefixed children are already in different namespace from parent's default
274
+ elsif !prefix && !ns_already_declared
275
+ attributes["xmlns"] = ns_uri
276
+ this_element_uses_default_ns = true
277
+ end
278
+ elsif plan && DeclarationPlanQuery.element_needs_xmlns_blank?(plan,
279
+ element)
280
+ # W3C Compliance: Element has no namespace (blank namespace)
281
+ attributes["xmlns"] = ""
282
+ elsif !plan
283
+ # Fallback logic when no plan is available
284
+ if parent_uses_default_ns
285
+ if parent_element_form_default == :qualified
286
+ # Child should INHERIT parent's namespace - no xmlns="" needed
287
+ else
288
+ # Parent's element_form_default is :unqualified - child in blank namespace
289
+ attributes["xmlns"] = ""
290
+ end
291
+ end
292
+ end
293
+
294
+ # Check if element was created from nil value with render_nil option
295
+ if element.is_a?(Lutaml::Xml::DataModel::XmlElement) && element.xsi_nil
296
+ attributes["xsi:nil"] = true
297
+ end
298
+
299
+ # Create element
300
+ xml.create_and_add_element(tag_name, attributes: attributes,
301
+ prefix: prefix) do |inner_xml|
302
+ # Handle raw content (map_all directive). lutaml-model#223:
303
+ # with coexisting mappings the raw remainder is the TAIL —
304
+ # mapped children render first through the normal paths
305
+ # below, then the fragment is appended. Standalone map_all
306
+ # (raw is the whole content) keeps the historical
307
+ # raw-only rendering by fronting the fragment and skipping
308
+ # children only when there is nothing mapped.
309
+ has_raw_content = false
310
+ if element.is_a?(Lutaml::Xml::DataModel::XmlElement)
311
+ raw_content = element.raw_content
312
+ if raw_content && !raw_content.to_s.empty?
313
+ if element.children.empty?
314
+ inner_xml.add_xml_fragment(inner_xml, raw_content.to_s)
315
+ has_raw_content = true
316
+ else
317
+ (tail_raw_fragments ||= []) << raw_content.to_s
318
+ end
319
+ end
320
+ end
321
+
322
+ # Skip text content and children if we have raw content
323
+ unless has_raw_content
324
+ # Add text content if present
325
+ if element.text_content
326
+ if element.cdata
327
+ inner_xml.cdata(element.text_content.to_s)
328
+ else
329
+ inner_xml.text(text_content_for_xml(element.text_content))
330
+ end
331
+ end
332
+
333
+ # Recursively build child elements, passing namespace context and plan
334
+ element.children.each do |child|
335
+ case child
336
+ when Lutaml::Xml::DataModel::XmlElement
337
+ build_xml_element(inner_xml, child,
338
+ parent_uses_default_ns: this_element_uses_default_ns,
339
+ parent_element_form_default: this_element_form_default,
340
+ parent_namespace_class: element_ns_class,
341
+ plan: plan,
342
+ xml_mapping: xml_mapping)
343
+ when Lutaml::Xml::DataModel::XmlComment
344
+ inner_xml.add_comment(child.content)
345
+ when Lutaml::Xml::DataModel::XmlRawFragment
346
+ inner_xml.add_xml_fragment(inner_xml, child.content)
347
+ when String
348
+ if element.cdata
349
+ inner_xml.cdata(child.to_s)
350
+ else
351
+ inner_xml.text(text_content_for_xml(child))
352
+ end
353
+ end
354
+ end
355
+ end
356
+ (tail_raw_fragments || []).each do |fragment|
357
+ inner_xml.add_xml_fragment(inner_xml, fragment)
358
+ end
359
+ end
360
+ end
361
+
362
+ # Build unordered child elements using prepared namespace declaration plan
363
+ #
364
+ # @param xml [Builder] the XML builder
365
+ # @param element [Object] the model instance
366
+ # @param plan [DeclarationPlan, Hash] the declaration plan
367
+ # @param options [Hash] serialization options
368
+ def build_unordered_children_with_plan(xml, element, plan, options)
369
+ mapper_class = options[:mapper_class] || element.class
370
+ xml_mapping = mapper_class.mappings_for(:xml)
371
+
372
+ # Process child elements with their plans (INCLUDING raw_mapping for map all)
373
+ mappings = xml_mapping.elements + [xml_mapping.raw_mapping].compact
374
+ mappings.each do |element_rule|
375
+ next if options[:except]&.include?(element_rule.to)
376
+
377
+ # Handle custom methods
378
+ if element_rule.custom_methods[:to]
379
+ mapper_class.new.public_send(element_rule.custom_methods[:to], element,
380
+ xml.parent, xml)
381
+ next
382
+ end
383
+
384
+ attribute_def = attribute_definition_for(element, element_rule,
385
+ mapper_class: mapper_class)
386
+
387
+ # For delegated attributes, attribute_def might be nil
388
+ next unless attribute_def || element_rule.delegate
389
+
390
+ value = attribute_value_for(element, element_rule)
391
+ next unless element_rule.render?(value, element)
392
+
393
+ # Get child's plan if available
394
+ child_plan = child_plan_for(plan, element_rule.to)
395
+
396
+ # Check if value is a Collection instance
397
+ is_collection_instance = value.is_a?(Lutaml::Model::Collection)
398
+
399
+ if value && (attribute_def&.type(register)&.<=(Lutaml::Model::Serialize) || is_collection_instance)
400
+ handle_nested_elements_with_plan(
401
+ xml,
402
+ value,
403
+ element_rule,
404
+ attribute_def,
405
+ child_plan,
406
+ options,
407
+ parent_plan: plan,
408
+ )
409
+ elsif element_rule.delegate && attribute_def.nil?
410
+ # Handle non-model values (strings, etc.) for delegated attributes
411
+ add_simple_value(xml, element_rule, value, nil, plan: plan,
412
+ mapping: xml_mapping, options: options)
413
+ else
414
+ add_simple_value(xml, element_rule, value, attribute_def,
415
+ plan: plan, mapping: xml_mapping, options: options)
416
+ end
417
+ end
418
+
419
+ # Process content mapping
420
+ process_content_mapping(element, xml_mapping.content_mapping,
421
+ xml, mapper_class)
422
+ end
423
+
424
+ # Build ordered child elements using prepared namespace declaration plan
425
+ #
426
+ # @param xml [Builder] the XML builder
427
+ # @param element [Object] the model instance
428
+ # @param plan [DeclarationPlan, Hash] the declaration plan
429
+ # @param options [Hash] serialization options
430
+ def build_ordered_element_with_plan(xml, element, plan, options)
431
+ mapper_class = options[:mapper_class] || element.class
432
+ xml_mapping = mapper_class.mappings_for(:xml)
433
+
434
+ index_hash = {}
435
+ content = []
436
+
437
+ element.element_order.each do |object|
438
+ object_key = "#{object.name}-#{object.type}"
439
+ index_hash[object_key] ||= -1
440
+ curr_index = index_hash[object_key] += 1
441
+
442
+ element_rule = xml_mapping.find_by_name(object.name,
443
+ type: object.type,
444
+ node_type: object.node_type,
445
+ namespace_uri: object.namespace_uri)
446
+ next if element_rule.nil? || options[:except]&.include?(element_rule.to)
447
+
448
+ # Handle custom methods
449
+ if element_rule.custom_methods[:to]
450
+ mapper_class.new.public_send(element_rule.custom_methods[:to], element,
451
+ xml.parent, xml)
452
+ next
453
+ end
454
+
455
+ # Get attribute definition and value (handle delegation)
456
+ attribute_def, value = fetch_attribute_and_value(element,
457
+ element_rule, mapper_class)
458
+
459
+ next if element_rule == xml_mapping.content_mapping && element_rule.cdata && object.text?
460
+
461
+ if element_rule == xml_mapping.content_mapping
462
+ process_ordered_content(element, xml_mapping, xml, curr_index,
463
+ content)
464
+ elsif !value.nil? || element_rule.render_nil?
465
+ process_ordered_element(xml, element, element_rule, attribute_def,
466
+ value, curr_index, plan, xml_mapping, options)
467
+ end
468
+ end
469
+
470
+ add_ordered_content(xml, content) unless content.empty?
471
+ end
472
+
473
+ private
474
+
475
+ def build_type_only_element(xml, element, xml_mapping, plan, options,
476
+ mapper_class)
477
+ if options[:tag_name]
478
+ xml.create_and_add_element(options[:tag_name]) do |inner_xml|
479
+ # Serialize type-only model's children inside parent's wrapper
480
+ xml_mapping.elements.each do |element_rule|
481
+ next if options[:except]&.include?(element_rule.to)
482
+
483
+ attribute_def = mapper_class.attributes[element_rule.to]
484
+ next unless attribute_def
485
+
486
+ value = element.public_send(element_rule.to)
487
+ next unless element_rule.render?(value, element)
488
+
489
+ # For type-only models, children plans may not be available
490
+ # Serialize children directly
491
+ if value && attribute_def.type(register)&.<=(Lutaml::Model::Serialize)
492
+ # Nested model - recursively build it
493
+ child_plan = plan.child_plan(element_rule.to) || DeclarationPlan.empty
494
+ build_element_with_plan(
495
+ inner_xml,
496
+ value,
497
+ child_plan,
498
+ { mapper_class: attribute_def.type(register),
499
+ tag_name: element_rule.name },
500
+ )
501
+ else
502
+ # Simple value - create element directly
503
+ inner_xml.create_and_add_element(element_rule.name) do
504
+ add_value(inner_xml, value, attribute_def,
505
+ cdata: element_rule.cdata)
506
+ end
507
+ end
508
+ end
509
+ end
510
+ else
511
+ # No wrapper at all - serialize children directly (for root-level type-only)
512
+ xml_mapping.elements.each do |element_rule|
513
+ next if options[:except]&.include?(element_rule.to)
514
+
515
+ attribute_def = mapper_class.attributes[element_rule.to]
516
+ next unless attribute_def
517
+
518
+ value = element.public_send(element_rule.to)
519
+ next unless element_rule.render?(value, element)
520
+
521
+ child_plan = plan.child_plan(element_rule.to)
522
+
523
+ if value && attribute_def.type(register)&.<=(Lutaml::Model::Serialize)
524
+ handle_nested_elements_with_plan(
525
+ xml,
526
+ value,
527
+ element_rule,
528
+ attribute_def,
529
+ child_plan,
530
+ options,
531
+ )
532
+ else
533
+ add_simple_value(xml, element_rule, value, attribute_def,
534
+ plan: plan, mapping: xml_mapping, options: options)
535
+ end
536
+ end
537
+ end
538
+ end
539
+
540
+ def handle_nested_elements_with_plan(xml, value, rule, attribute, plan,
541
+ options, parent_plan: nil)
542
+ element_options = options.merge(
543
+ rule: rule,
544
+ attribute: attribute,
545
+ tag_name: rule.name,
546
+ mapper_class: attribute.type(register), # Override with child's type
547
+ )
548
+
549
+ # Handle Collection instances
550
+ if value.is_a?(Lutaml::Model::Collection)
551
+ build_collection_elements(xml, value, attribute, rule,
552
+ element_options, parent_plan, options)
553
+ return
554
+ end
555
+
556
+ case value
557
+ when Array
558
+ build_array_elements(xml, value, attribute, rule, element_options,
559
+ plan, parent_plan, options)
560
+ else
561
+ build_element_with_plan(xml, value, plan, element_options)
562
+ end
563
+ end
564
+
565
+ def build_collection_elements(xml, value, attribute, rule,
566
+ element_options, parent_plan, options)
567
+ items = value.collection
568
+ attr_type = attribute.type(register)
569
+
570
+ if attr_type <= Lutaml::Model::Type::Value
571
+ # Simple types - use add_simple_value for each item
572
+ items.each do |val|
573
+ xml_mapping = options[:mapper_class]&.mappings_for(:xml)
574
+ add_simple_value(xml, rule, val, attribute, plan: parent_plan,
575
+ mapping: xml_mapping, options: options)
576
+ end
577
+ else
578
+ # Model types - build elements with plans
579
+ items.each do |val|
580
+ item_plan = plan_for_collection_item(val, attribute, parent_plan,
581
+ options)
582
+ item_mapper_class = if polymorphic_value?(attribute, val)
583
+ val.class
584
+ else
585
+ attribute.type(register)
586
+ end
587
+ item_options = element_options.merge(mapper_class: item_mapper_class)
588
+ build_element_with_plan(xml, val, item_plan, item_options)
589
+ end
590
+ end
591
+ end
592
+
593
+ def build_array_elements(xml, value, attribute, _rule, element_options,
594
+ _plan, parent_plan, options)
595
+ value.each do |val|
596
+ item_mapper_class = if polymorphic_value?(attribute, val)
597
+ val.class
598
+ else
599
+ attribute.type(register)
600
+ end
601
+
602
+ item_plan = plan_for_collection_item(val, attribute, parent_plan,
603
+ options)
604
+ item_options = element_options.merge(mapper_class: item_mapper_class)
605
+ build_element_with_plan(xml, val,
606
+ item_plan || DeclarationPlan.empty, item_options)
607
+ end
608
+ end
609
+
610
+ def plan_for_collection_item(val, attribute, parent_plan, options)
611
+ item_mapper_class = if polymorphic_value?(attribute, val)
612
+ val.class
613
+ else
614
+ attribute.type(register)
615
+ end
616
+
617
+ item_mapping = item_mapper_class.mappings_for(:xml)
618
+ return nil unless item_mapping
619
+
620
+ # Transform model to XmlElement tree
621
+ transformation = item_mapper_class.transformation_for(:xml, register)
622
+ xml_element = transformation.transform(val, options)
623
+
624
+ # Collect namespace needs from XmlElement tree
625
+ collector = NamespaceCollector.new(register)
626
+ item_needs = collector.collect(xml_element, item_mapping,
627
+ mapper_class: item_mapper_class)
628
+
629
+ # Plan with XmlElement tree (not model instance)
630
+ planner = DeclarationPlanner.new(register)
631
+ planner.plan(xml_element, item_mapping, item_needs,
632
+ parent_plan: parent_plan, options: options)
633
+ end
634
+
635
+ # Add simple (non-model) values to XML
636
+ def add_simple_value(xml, rule, value, attribute, plan: nil,
637
+ mapping: nil, options: {})
638
+ value = rule.render_value_for(value) if rule
639
+
640
+ if value.is_a?(Array)
641
+ if value.empty?
642
+ if rule.render_empty?
643
+ if rule.render_empty_as_nil?
644
+ xml.create_and_add_element(rule.name,
645
+ attributes: { "xsi:nil" => true },
646
+ prefix: nil)
647
+ else
648
+ xml.create_and_add_element(rule.name,
649
+ attributes: nil,
650
+ prefix: nil)
651
+ end
652
+ end
653
+ return
654
+ end
655
+
656
+ value.each do |val|
657
+ add_simple_value(xml, rule, val, attribute, plan: plan,
658
+ mapping: mapping, options: options)
659
+ end
660
+ return
661
+ end
662
+
663
+ resolved_prefix, attributes = resolve_simple_value_namespace(
664
+ rule, attribute, mapping, plan, options
665
+ )
666
+
667
+ render_simple_value_element(xml, rule, value, attribute,
668
+ resolved_prefix, attributes)
669
+ end
670
+
671
+ def resolve_simple_value_namespace(rule, attribute, mapping, plan,
672
+ options)
673
+ resolver = NamespaceResolver.new(register)
674
+
675
+ # Extract parent_uses_default_ns from options or calculate it
676
+ parent_uses_default_ns = options[:parent_uses_default_ns]
677
+ if parent_uses_default_ns.nil?
678
+ parent_uses_default_ns = if mapping&.namespace_class && plan
679
+ DeclarationPlanQuery.declared_at_root_default_format?(plan,
680
+ mapping.namespace_class)
681
+ else
682
+ false
683
+ end
684
+ end
685
+
686
+ # Resolve namespace using the resolver
687
+ ns_result = resolver.resolve_for_element(rule, attribute, mapping,
688
+ plan, options)
689
+ resolved_prefix = ns_result[:prefix]
690
+ type_ns_info = ns_result[:ns_info]
691
+
692
+ # CRITICAL FIX: Type namespace format inheritance for namespace_scope
693
+ type_ns_class = if attribute && !rule.namespace_set?
694
+ type_class = attribute.type(register)
695
+ type_class.namespace_class if type_class.is_a?(Class) && type_class <= Lutaml::Model::Type::Value
696
+ end
697
+
698
+ format_from_stored_plan = false
699
+
700
+ if type_ns_class
701
+ check_plan = plan || options[:stored_xml_declaration_plan]
702
+ if check_plan
703
+ stored_ns_decl = check_plan.namespaces.values.find do |decl|
704
+ decl.uri == type_ns_class.uri
705
+ end
706
+ if stored_ns_decl
707
+ resolved_prefix = if stored_ns_decl.local_on_use? || stored_ns_decl.prefix_format?
708
+ stored_ns_decl.prefix
709
+ end
710
+ format_from_stored_plan = true
711
+ end
712
+ end
713
+ end
714
+
715
+ # BUG FIX #49: Check if child element is in same namespace as parent
716
+ unless format_from_stored_plan
717
+ element_has_no_explicit_ns = !rule.namespace_set?
718
+ type_class = attribute&.type(register)
719
+ type_has_no_ns = !(type_class.is_a?(Class) && type_class <= Lutaml::Model::Type::Value) ||
720
+ !type_class&.namespace_class
721
+
722
+ parent_ns_class = options[:parent_namespace_class]
723
+ parent_ns_decl = options[:parent_ns_decl]
724
+ parent_ns_uri = parent_ns_class&.uri
725
+ child_ns_uri = ns_result[:uri]
726
+
727
+ resolved_prefix = if element_has_no_explicit_ns && type_has_no_ns
728
+ nil
729
+ elsif parent_ns_class && parent_ns_decl &&
730
+ child_ns_uri && parent_ns_uri &&
731
+ child_ns_uri == parent_ns_uri
732
+ if parent_ns_decl.prefix_format?
733
+ parent_ns_decl.prefix
734
+ end
735
+ else
736
+ ns_result[:prefix]
737
+ end
738
+ end
739
+
740
+ # Prepare attributes for element creation
741
+ attributes = {}
742
+
743
+ # W3C COMPLIANCE: Use resolver to determine xmlns="" requirement
744
+ if resolver.xmlns_blank_required?(ns_result, parent_uses_default_ns)
745
+ attributes["xmlns"] = ""
746
+ end
747
+
748
+ # Check if this namespace needs local declaration (out of scope)
749
+ if resolved_prefix && plan&.namespaces
750
+ ns_entry = plan.namespaces.values.find do |ns_decl|
751
+ ns_decl.ns_object.prefix_default == resolved_prefix ||
752
+ (type_ns_info && type_ns_info[:uri] && ns_decl.ns_object.uri == type_ns_info[:uri])
753
+ end
754
+
755
+ if ns_entry&.local_on_use?
756
+ xmlns_attr = resolved_prefix ? "xmlns:#{resolved_prefix}" : "xmlns"
757
+ attributes[xmlns_attr] = ns_entry.ns_object.uri
758
+ end
759
+ end
760
+
761
+ [resolved_prefix, attributes]
762
+ end
763
+
764
+ def render_simple_value_element(xml, rule, value, attribute,
765
+ resolved_prefix, attributes)
766
+ if value.nil?
767
+ if rule.render_nil_as_blank? || rule.render_nil_as_empty?
768
+ xml.create_and_add_element(rule.name,
769
+ attributes: attributes.empty? ? nil : attributes,
770
+ prefix: resolved_prefix)
771
+ else
772
+ xml.create_and_add_element(rule.name,
773
+ attributes: attributes.merge({ "xsi:nil" => true }),
774
+ prefix: resolved_prefix)
775
+ end
776
+ elsif ::Lutaml::Model::Utils.uninitialized?(value)
777
+ nil
778
+ elsif ::Lutaml::Model::Utils.empty?(value)
779
+ xml.create_and_add_element(rule.name,
780
+ attributes: attributes.empty? ? nil : attributes,
781
+ prefix: resolved_prefix)
782
+ elsif rule.raw_mapping? || rule.raw == :element
783
+ xml.add_xml_fragment(xml, value)
784
+ elsif value.is_a?(::Hash) && attribute&.type(register) == Lutaml::Model::Type::Hash
785
+ xml.create_and_add_element(rule.name,
786
+ attributes: attributes.empty? ? nil : attributes,
787
+ prefix: resolved_prefix) do
788
+ value.each do |key, val|
789
+ xml.create_and_add_element(key.to_s) do
790
+ xml.add_text(xml, val.to_s)
791
+ end
792
+ end
793
+ end
794
+ else
795
+ xml.create_and_add_element(rule.name,
796
+ attributes: attributes.empty? ? nil : attributes,
797
+ prefix: resolved_prefix) do
798
+ add_value(xml, value, attribute, cdata: rule.cdata)
799
+ end
800
+ end
801
+ end
802
+
803
+ # Get child plan from parent plan
804
+ #
805
+ # @param plan [DeclarationPlan, nil] the parent plan
806
+ # @param attr_name [Symbol] the attribute name
807
+ # @return [DeclarationPlan, nil] the child plan or nil
808
+ def child_plan_for(plan, attr_name)
809
+ plan&.child_plan(attr_name)
810
+ end
811
+
812
+ # Fetch attribute definition and value, handling delegation
813
+ #
814
+ # @param element [Object] the model instance
815
+ # @param element_rule [MappingRule] the mapping rule
816
+ # @param mapper_class [Class] the mapper class
817
+ # @return [Array<(Attribute, Object)>] attribute definition and value tuple
818
+ def fetch_attribute_and_value(element, element_rule, mapper_class)
819
+ attribute_def = nil
820
+ value = nil
821
+
822
+ if element_rule.delegate
823
+ delegate_obj = element.public_send(element_rule.delegate)
824
+ if delegate_obj.is_a?(Lutaml::Model::Serialize) && delegate_obj.class.attributes.key?(element_rule.to)
825
+ attribute_def = delegate_obj.class.attributes[element_rule.to]
826
+ value = delegate_obj.public_send(element_rule.to)
827
+ end
828
+ else
829
+ attribute_def = attribute_definition_for(element, element_rule,
830
+ mapper_class: mapper_class)
831
+ value = attribute_value_for(element, element_rule)
832
+ end
833
+
834
+ [attribute_def, value]
835
+ end
836
+
837
+ # Process content for ordered elements
838
+ #
839
+ # @param element [Object] the model instance
840
+ # @param xml_mapping [Xml::Mapping] the XML mapping
841
+ # @param xml [Builder] the XML builder
842
+ # @param curr_index [Integer] current index in collection
843
+ # @param content [Array] accumulated content strings
844
+ def process_ordered_content(element, xml_mapping, xml, curr_index,
845
+ content)
846
+ text = element.public_send(xml_mapping.content_mapping.to)
847
+ text = text[curr_index] if text.is_a?(Array)
848
+
849
+ if element.mixed?
850
+ add_mixed_text(xml, text)
851
+ else
852
+ content << text
853
+ end
854
+ end
855
+
856
+ # Process a single ordered element
857
+ #
858
+ # @param xml [Builder] the XML builder
859
+ # @param element [Object] the model instance
860
+ # @param element_rule [MappingRule] the mapping rule
861
+ # @param attribute_def [Attribute, nil] the attribute definition
862
+ # @param value [Object] the value
863
+ # @param curr_index [Integer] current index in collection
864
+ # @param plan [DeclarationPlan, Hash] the declaration plan
865
+ # @param xml_mapping [Xml::Mapping] the XML mapping
866
+ # @param options [Hash] serialization options
867
+ def process_ordered_element(xml, element, element_rule, attribute_def,
868
+ value, curr_index, plan, xml_mapping, options)
869
+ # Handle collection values by index
870
+ current_value = if attribute_def&.collection? && value.is_a?(Array)
871
+ value[curr_index]
872
+ elsif attribute_def&.collection? && value.is_a?(Lutaml::Model::Collection)
873
+ value.to_a[curr_index]
874
+ else
875
+ value
876
+ end
877
+
878
+ # Get child's plan if available
879
+ child_plan = child_plan_for(plan, element_rule.to)
880
+
881
+ is_collection_instance = current_value.is_a?(Lutaml::Model::Collection)
882
+
883
+ if current_value && (attribute_def&.type(register)&.<=(Lutaml::Model::Serialize) || is_collection_instance)
884
+ handle_nested_elements_with_plan(
885
+ xml,
886
+ current_value,
887
+ element_rule,
888
+ attribute_def,
889
+ child_plan,
890
+ options,
891
+ parent_plan: plan,
892
+ )
893
+ else
894
+ # Apply transformations if attribute_def exists
895
+ if attribute_def
896
+ current_value = ExportTransformer.call(current_value,
897
+ element_rule, attribute_def, format: :xml)
898
+ end
899
+
900
+ # For mixed content, create elements directly
901
+ if element.mixed? && !attribute_def&.raw?
902
+ add_mixed_element(xml, element_rule, current_value, attribute_def,
903
+ plan: plan, mapping: xml_mapping)
904
+ else
905
+ add_simple_value(xml, element_rule, current_value,
906
+ attribute_def, plan: plan, mapping: xml_mapping, options: options)
907
+ end
908
+ end
909
+ end
910
+
911
+ # Add text for mixed content (can be overridden by adapters)
912
+ #
913
+ # @param xml [Builder] the XML builder
914
+ # @param text [String] the text to add
915
+ def add_mixed_text(xml, text)
916
+ xml.add_text(xml, text) unless text.nil? || text.to_s.empty?
917
+ end
918
+
919
+ # Add element for mixed content (can be overridden by adapters)
920
+ #
921
+ # @param xml [Builder] the XML builder
922
+ # @param element_rule [MappingRule] the element rule
923
+ # @param value [Object] the value to add
924
+ # @param attribute [Attribute, nil] the attribute definition
925
+ # @param plan [DeclarationPlan, Hash, nil] the declaration plan
926
+ # @param mapping [Xml::Mapping] the XML mapping
927
+ def add_mixed_element(xml, element_rule, value, _attribute,
928
+ plan: nil, mapping: nil) # rubocop:disable Lint/UnusedMethodArgument
929
+ xml.create_and_add_element(element_rule.name) do |child_element|
930
+ child_element.text(value.to_s) unless ::Lutaml::Model::Utils.empty?(value)
931
+ end
932
+ end
933
+
934
+ # Add accumulated content (can be overridden by adapters)
935
+ #
936
+ # @param xml [Builder] the XML builder
937
+ # @param content [Array<String>] accumulated content strings
938
+ def add_ordered_content(xml, content)
939
+ xml.add_text(xml, content.join)
940
+ end
941
+ end
942
+ end
943
+ end
944
+ end