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,827 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Lutaml
4
+ module Xml
5
+ module Leptris
6
+ # Hydrates model instances from a Descriptor#walk PlanValue tree,
7
+ # keyed by each value's producing row name (never position — rows
8
+ # for missing elements are simply absent). Native rows build
9
+ # constructor kwargs; deferred rows (custom methods, polymorphism,
10
+ # unions) capture their subtree verbatim and interpret it
11
+ # post-walk — the fragment parse runs the existing interpretive
12
+ # machinery on just that island. Delegate rules hydrate
13
+ # post-instance onto their target object. Collection rows route
14
+ # natively when a single one exists, else through callback rows
15
+ # (their values echo name and type_tag; native collection values
16
+ # echo neither — leptris-ruby#220).
17
+ module PlanHydrator
18
+ # Row kinds whose child type/plan resolve once per plan (see
19
+ # child_row_plans).
20
+ CHILD_ROW_KINDS = %i[nested ordered_deferred].freeze
21
+
22
+ class << self
23
+ # plan: the compiled plan entry for model_class
24
+ # value: the walk root PlanValue (element)
25
+ # node: the parsed source element (leptris); ordered/mixed
26
+ # plans rebuild element_order from it and ordered children
27
+ # hydrate natively against their own nodes
28
+ # declaration_plan_mode: mirrors from_xml's
29
+ # :import_declaration_plan option (:skip records nothing;
30
+ # :lazy is honored as :eager — the lazy variant pins the
31
+ # raw engine DOM, the retention the eager default exists
32
+ # to avoid)
33
+ def call(model_class, plan, value, parent: nil, node: nil,
34
+ register: nil, declaration_plan_mode: :eager, intern: nil)
35
+ # The child model's declared lutaml_default_register takes
36
+ # precedence over the ambient register — the same
37
+ # resolve_for_child contract the interpretive path applies.
38
+ # Without it, hydration resolves the child's symbol attribute
39
+ # types in the parent context and raises UnknownTypeError
40
+ # for ids registered only in the child's register (#876).
41
+ register = Lutaml::Model::Register.resolve_for_child(
42
+ model_class, register || Lutaml::Model::Config.default_register
43
+ )
44
+ # Per-parse intern table: element_order entries (and the
45
+ # namespace snapshot below) mint one FFI string per child
46
+ # per node; a 2M-node document then retains millions of
47
+ # duplicate name/URI strings inside the summaries. One
48
+ # shared table per parse collapses them to distinct strings.
49
+ intern ||= {}
50
+ buckets = if node && plan[:needs_nodes]
51
+ element_buckets(node, plan[:contested_names])
52
+ end
53
+ attr_kwargs = attributes_kwargs(plan, value, node)
54
+ child_kwargs, children, delegates, run_children =
55
+ children_kwargs(model_class, plan, value, buckets, register,
56
+ intern)
57
+ plan[:collection_defaults].each do |name|
58
+ next if attr_kwargs.key?(name) || child_kwargs.key?(name)
59
+
60
+ child_kwargs[name] = []
61
+ end
62
+ # TODO.max-perf/33: the bulk constructor — allocate +
63
+ # compiled writers, from_hash semantics — measured ~30x on
64
+ # hydration-heavy corpora versus the generic constructor.
65
+ attr_kwargs.update(child_kwargs)
66
+ instance = model_class.instantiate(attr_kwargs, register)
67
+ instance.lutaml_parent = parent if parent
68
+ instance.lutaml_root ||= parent&.lutaml_root || parent
69
+ # Root prefix fidelity (the interpretive transform records
70
+ # it from the source element): prefixed sources keep their
71
+ # prefixes through the serialize lane's format
72
+ # preservation.
73
+ if parent.nil? && node.respond_to?(:prefix) && node.prefix &&
74
+ !node.prefix.empty?
75
+ instance.xml_namespace_prefix = node.prefix
76
+ end
77
+ # #909: order summaries are per-instance pinned records —
78
+ # read-only consumers skip them via the config.
79
+ if node && plan[:ordered] &&
80
+ Lutaml::Model::Config.instance.element_order_tracking
81
+ instance.element_order = PlanOrder.build(node, intern)
82
+ end
83
+ # Root declaration-plan parity (the interpretive
84
+ # transform's eager mode): consumers and the interpretive
85
+ # serialize fallback read import_declaration_plan state —
86
+ # plan-hydrated roots must carry the same in-scope xmlns
87
+ # declarations or round-trips drop them (#872). The root's
88
+ # xsi:schemaLocation rides the same state (the
89
+ # interpretive set_schema_location contract).
90
+ if parent.nil? && node
91
+ record_declaration_plan(instance, node, model_class) if declaration_plan_mode != :skip
92
+ record_schema_location(instance, node, model_class, register)
93
+ end
94
+ children.each do |child|
95
+ child.lutaml_parent = instance
96
+ child.lutaml_root ||= instance.lutaml_root || instance
97
+ end
98
+ interpret_deferred(model_class, plan, value, instance, node,
99
+ buckets, run_children)
100
+ route_delegates(delegates, instance)
101
+ instance
102
+ end
103
+
104
+ # leptris#1874: snapshot rows -> the ns_data hash
105
+ # ({path => {prefix_key => {uri:, prefix:, format:}}}), the
106
+ # exact shape the recursion builds. Public: it is the
107
+ # contract the binding's snapshot rows must satisfy.
108
+ def ns_data_from_snapshot_rows(rows)
109
+ rows.each_with_object({}) do |row, result|
110
+ prefix = row[:prefix]
111
+ # One element carrying several declarations emits one
112
+ # row PER declaration with the same path — merge them,
113
+ # exactly as the recursion accumulates per path.
114
+ (result[row[:path]] ||= {})[row[:prefix] || :default] = {
115
+ uri: row[:href], prefix: prefix,
116
+ format: prefix ? :prefix : :default
117
+ }
118
+ end
119
+ end
120
+
121
+ def collect_native_namespaces(element, path = [], result = {})
122
+ if element.respond_to?(:namespace_declarations_snapshot)
123
+ return ns_data_from_snapshot_rows(
124
+ element.namespace_declarations_snapshot,
125
+ )
126
+ end
127
+
128
+ own = element.namespace_definitions
129
+ unless own.empty?
130
+ namespaces = {}
131
+ own.each do |ns|
132
+ key = ns.prefix || :default
133
+ namespaces[key] = { uri: ns.href, prefix: ns.prefix,
134
+ format: ns.prefix ? :prefix : :default }
135
+ end
136
+ result[path.dup] = namespaces
137
+ end
138
+ element.children.each do |child|
139
+ next unless child.is_a?(::Leptris::XML::Element)
140
+
141
+ path.push(child.name)
142
+ collect_native_namespaces(child, path, result)
143
+ path.pop
144
+ end
145
+ result
146
+ end
147
+
148
+ private
149
+
150
+ def record_declaration_plan(instance, node, model_class)
151
+ ns_data = collect_native_namespaces(node)
152
+ return if ns_data.empty?
153
+
154
+ plan = Lutaml::Xml::DeclarationPlan.from_input_with_locations(
155
+ ns_data, model_class.mappings_for(:xml)
156
+ )
157
+ instance.import_declaration_plan = plan if plan
158
+ end
159
+
160
+ # The interpretive parse stores the root's xsi:schemaLocation
161
+ # verbatim (set_schema_location); the writer re-emits it.
162
+ def record_schema_location(instance, node, model_class, register)
163
+ xml_mapping = model_class.mappings_for(:xml, register)
164
+ return if xml_mapping&.schema_location_mapped?(register)
165
+
166
+ schema_loc = node.attributes.each_value.find do |a|
167
+ a.name.to_s.split(":", 2).last == "schemaLocation"
168
+ end
169
+ instance.raw_schema_location = schema_loc.value if schema_loc
170
+ end
171
+
172
+ # Same ns_data shape as ModelTransform.collect_element_namespaces,
173
+ # collected straight off the engine nodes — no wrapper tree.
174
+ # Iterates children with an inline element filter:
175
+ # element_children materializes a filtered array per node,
176
+ # which the niso allocation gate caught at scale.
177
+ #
178
+ # leptris#1874: when the binding exposes the bulk snapshot
179
+ # face (namespace_declarations_snapshot — one FFI crossing
180
+ # for the whole subtree; shipped engine-side in 1.9.387),
181
+ # the whole-subtree Ruby recursion collapses into a single
182
+ # call. Rows: {path: [names...], prefix: String|nil,
183
+ # href: String} in pre-order, paths relative to the
184
+ # receiver. The face probe keeps older bindings on the
185
+ # recursion unchanged.
186
+ def register
187
+ Lutaml::Model::Config.default_register
188
+ end
189
+
190
+ def attributes_kwargs(plan, value, node = nil)
191
+ kwargs = {}
192
+ sole_claimants = sole_claimant_names(plan)
193
+ ns_attr_names = plan[:ns_attr_names]
194
+ rows = plan_attr_rows(plan)
195
+ # #1670 batch face (leptris 1.9.351.1): one FFI crossing
196
+ # per node instead of one per (node x attribute name).
197
+ bound = value.attributes_snapshot
198
+ rows.each do |rule, attr, name|
199
+ v = bound[name]
200
+ if v.nil? && node && sole_claimants.include?(name)
201
+ # #754/#790 parity: a sole-claimant attribute rule binds
202
+ # any qualification (the interpretive matcher's lenient
203
+ # recovery). The walk captures exact (URI, local) matches
204
+ # only, so the qualified spelling is read off the node.
205
+ v = lenient_node_attribute(node, name)
206
+ end
207
+ next if v.nil?
208
+
209
+ # (URI, local) rows mirror the interpretive matcher's
210
+ # ambiguity refusal: a second spelling of the same local
211
+ # name binds nothing (lutaml-model#744).
212
+ if ns_attr_names&.include?(name) &&
213
+ ambiguous_local_spellings?(node, name)
214
+ next
215
+ end
216
+
217
+ v = v.split(rule.delimiter) if rule.delimiter
218
+ if rule.as_list && rule.as_list[:import]
219
+ v = rule.as_list[:import].call(v)
220
+ end
221
+ kwargs[attr.name.to_sym] = v
222
+ end
223
+ kwargs
224
+ end
225
+
226
+ # True when the node carries more than one spelling of the
227
+ # local name (any qualification). Only consulted for exact-URI
228
+ # attribute rows.
229
+ def ambiguous_local_spellings?(node, local_name)
230
+ return false unless node.respond_to?(:attributes)
231
+
232
+ # Allocation-free: the local part is compared as a suffix of
233
+ # the raw name instead of splitting out a fresh substring.
234
+ llen = local_name.length
235
+ seen = false
236
+ node.attributes.each_value do |attr|
237
+ name = attr.name.to_s
238
+ if (colon = name.rindex(":"))
239
+ next unless name.length - colon - 1 == llen &&
240
+ name.end_with?(local_name)
241
+ elsif name != local_name
242
+ next
243
+ end
244
+
245
+ return true if seen
246
+
247
+ seen = true
248
+ end
249
+ false
250
+ end
251
+
252
+ # A captured-but-empty child marshals as a nil string value.
253
+ # The interpretive pipeline classifies the raw "" through the
254
+ # rule's value map (:empty key) — the :empty directive (the
255
+ # plain-rule default) keeps it as "", :nil binds nil, and any
256
+ # other directive means uninitialized, i.e. no binding.
257
+ def mapped_empty_value(rule)
258
+ case rule.value_map(:from)[:empty]
259
+ when :nil then nil
260
+ when :empty then ""
261
+ else :skip
262
+ end
263
+ end
264
+
265
+ def mapped_capture_values(values, rule)
266
+ return values unless values.include?(nil)
267
+
268
+ mapped = mapped_empty_value(rule)
269
+ out = []
270
+ values.each do |item|
271
+ if item.nil?
272
+ out << mapped unless mapped == :skip
273
+ else
274
+ out << item
275
+ end
276
+ end
277
+ out
278
+ end
279
+
280
+ # Wire-name strings are plan-frozen; materializing them per
281
+ # hydration allocated two or three strings per attribute row
282
+ # per instance.
283
+ def plan_attr_rows(plan)
284
+ plan[:attr_row_names] ||= plan[:attr_rows].map do |rule, attr, row_name|
285
+ [rule, attr, row_name || rule.name.to_s]
286
+ end
287
+ end
288
+
289
+ # Returns [kwargs, hydrated_child_instances, delegate_values]
290
+ # — child instances come back so the caller can decorate
291
+ # parent/root links once the parent exists; delegate values
292
+ # wait for the instance (their target object must exist).
293
+ def children_kwargs(_model_class, plan, value, buckets = nil,
294
+ register = nil, intern = {})
295
+ register ||= Lutaml::Model::Config.default_register
296
+ grouped, tagged, run_children = group_children(value,
297
+ plan[:row_tags])
298
+ buckets = nil unless buckets && plan[:needs_nodes]
299
+ kwargs = {}
300
+ children = []
301
+ delegates = []
302
+ # Lazy: models without multi-spelling rows never touch it, and
303
+ # the block-backed Hash is a fresh object per hydrated row.
304
+ spellings = nil
305
+ row_tags = plan[:row_tags]
306
+ wire_names = row_wire_names(plan)
307
+ row_memo = child_row_plans(plan, register)
308
+ # Array#each with a top-of-loop counter: each_with_index
309
+ # mints an enumerator per hydrated node — 14.7K allocations
310
+ # per parse on the pnas guardrail — and next must keep its
311
+ # continue semantics.
312
+ rows = plan[:rows]
313
+ idx = -1
314
+ # rubocop:disable Metrics/BlockLength -- one row-kind
315
+ # dispatch table; splitting it would scatter the contract
316
+ rows.each do |row|
317
+ idx += 1
318
+ rule, attr, kind, spelling, delegate, _row_type = row
319
+ tag = row_tags&.[](idx)
320
+ name = wire_names[idx]
321
+ case kind
322
+ when :scalar
323
+ # Raw passthrough: the model constructor is the single
324
+ # cast authority — pre-casting here doubled every cast.
325
+ # Class transforms still apply before assignment.
326
+ if tag && (vals = tagged[tag]) && vals.size > 1
327
+ # Interpretive parity: several captures into a
328
+ # non-collection attribute arrive as the full array.
329
+ v = vals.map(&:string_value)
330
+ if v.include?(nil)
331
+ v = v.map { |item| item.nil? ? mapped_empty_value(rule) : item }
332
+ v.reject! { |item| item == :skip }
333
+ end
334
+ else
335
+ first = if tag
336
+ tagged[tag]&.first
337
+ else
338
+ grouped.dig(name, 0)
339
+ end
340
+ v = first&.string_value
341
+ v = mapped_empty_value(rule) if v.nil? && first
342
+ end
343
+ unless v.nil? || v == :skip
344
+ v = rule.transform_value(attr, v, :from, :xml) if rule.transform.is_a?(Class)
345
+ assign(kwargs, delegates, delegate, rule, attr, v)
346
+ end
347
+ when :wildcard_any
348
+ # interpreted post-instance (interpret_deferred)
349
+ when :content
350
+ runs = content_runs(value, run_children)
351
+ if runs.empty? && !attr.collection?
352
+ # An empty element's content binds through the rule's
353
+ # value map for scalar content attributes: "" for the
354
+ # plain :empty directive, nil for :nil, skipped for
355
+ # anything else (uninitialized).
356
+ bound = mapped_empty_value(rule)
357
+ assign(kwargs, delegates, delegate, rule, attr, bound) unless bound == :skip
358
+ else
359
+ assign(kwargs, delegates, delegate, rule, attr, runs)
360
+ end
361
+ when :ordered_deferred
362
+ # With a source node the child hydrates natively: one
363
+ # walk against its own node + element_order from the
364
+ # node's children. Without one (direct PlanHydrator
365
+ # use), the subtree fragment-parses interpretively.
366
+ if buckets && row_memo[idx]
367
+ child_type, child_plan, child_register, contested = row_memo[idx]
368
+ selected = child_selection(buckets, name, child_plan, contested)
369
+ items = (selected || []).map do |n|
370
+ call(child_type, child_plan,
371
+ child_plan[:descriptor].walk(n), node: n,
372
+ register: child_register, intern: intern)
373
+ end
374
+ unless items.empty?
375
+ children.concat(items)
376
+ assign(kwargs, delegates, delegate, rule, attr,
377
+ attr.collection? ? items : items.first)
378
+ end
379
+ end
380
+ when :child_deferred
381
+ # Uncompilable child (cycles, opted-out shapes): each
382
+ # source node casts through the attribute — the full
383
+ # interpretive machinery on the bridged island,
384
+ # identical semantics to the interpretive path.
385
+ contested_uri = if plan[:contested_names]&.include?(name)
386
+ child_type_uri(attr, register)
387
+ end
388
+ elements = deferred_elements(value, name, buckets,
389
+ contested_uri)
390
+ next if elements.empty?
391
+
392
+ results = elements.map do |element|
393
+ attr.cast(element, :xml, register)
394
+ end
395
+ unless results.empty?
396
+ children.concat(results)
397
+ assign(kwargs, delegates, delegate, rule, attr,
398
+ attr.collection? ? results : results.first)
399
+ end
400
+ when :collection_cb
401
+ values = grouped[name].to_a.map do |item|
402
+ item&.string_value
403
+ end
404
+ values = mapped_capture_values(values, rule)
405
+ if rule.transform.is_a?(Class)
406
+ values = values.map { |v| rule.transform_value(attr, v, :from, :xml) }
407
+ end
408
+ unless values.empty?
409
+ assign(kwargs, delegates, delegate, rule, attr, values)
410
+ end
411
+ when :collection_native
412
+ values = if tag
413
+ tagged[tag].to_a.map(&:string_value)
414
+ else
415
+ native_collection(value, name)
416
+ end
417
+ values = mapped_capture_values(values, rule) unless values.nil?
418
+ unless values.nil?
419
+ assign(kwargs, delegates, delegate, rule, attr, values)
420
+ end
421
+ when :spelling
422
+ spellings ||= Hash.new { |h, k| h[k] = [] }
423
+ spellings[[rule, attr]] << grouped[spelling.to_s].to_a
424
+ when :nested
425
+ child_type, child_plan, child_register, contested = row_memo[idx]
426
+ selected = child_selection(buckets, name, child_plan, contested)
427
+ if selected && contested
428
+ # Contested name: the walk's grouped values cross-echo
429
+ # every same-name element into every row — dispatch
430
+ # per source node instead (the walk is row-scoped).
431
+ items = selected.map do |n|
432
+ call(child_type, child_plan,
433
+ child_plan[:descriptor].walk(n), node: n,
434
+ register: child_register, intern: intern)
435
+ end
436
+ else
437
+ values = grouped.fetch(name, [])
438
+ cursor = if child_plan[:needs_nodes] && buckets
439
+ selected
440
+ end
441
+ # Indexed loop: each_with_index.map mints an
442
+ # enumerator per node with nested rows.
443
+ count = values.size
444
+ items = Array.new(count)
445
+ pos = 0
446
+ while pos < count
447
+ items[pos] = call(child_type, child_plan, values[pos],
448
+ node: cursor && cursor[pos],
449
+ register: child_register, intern: intern)
450
+ pos += 1
451
+ end
452
+ end
453
+ next if items.empty?
454
+
455
+ children.concat(items)
456
+ assign(kwargs, delegates, delegate, rule, attr,
457
+ attr.collection? ? items : items.first)
458
+ end
459
+ end
460
+ # rubocop:enable Metrics/BlockLength
461
+ unless !spellings || spellings.empty?
462
+ spellings.each do |(rule, attr), groups|
463
+ # Interpretive order for shared-attribute groups is
464
+ # spelling-group order (first spelling's matches, then
465
+ # the next's), not interleaved document order.
466
+ values = groups.compact.flatten.map(&:string_value)
467
+ next if values.empty?
468
+
469
+ delegate = delegate_of(plan, rule)
470
+ assign(kwargs, delegates, delegate, rule, attr,
471
+ attr.collection? ? values : values.first)
472
+ end
473
+ end
474
+ [kwargs, children, delegates, run_children]
475
+ end
476
+
477
+ # Deferred islands: raw subtrees become wrapper elements via a
478
+ # fragment parse, then the interpretive machinery runs on just
479
+ # that island — custom method invocation with an
480
+ # element-shaped argument, or the polymorphic/union cast.
481
+ # With the source node available the island wraps the ORIGINAL
482
+ # node (no fragment parse — the reparse dominated deferred
483
+ # hydration). Ordered children only land here without a node.
484
+ def interpret_deferred(model_class, plan, value, instance, node = nil,
485
+ buckets = nil, run_children = nil)
486
+ # Array#each + top counter: no per-node enumerator (see
487
+ # children_kwargs).
488
+ rows = plan[:rows]
489
+ idx = -1
490
+ rows.each do |row|
491
+ idx += 1
492
+ rule = row[0]
493
+ attr = row[1]
494
+ kind = row[2]
495
+ wire_name = row_wire_names(plan)[idx]
496
+ case kind
497
+ when :content_deferred
498
+ runs = content_runs(value, run_children)
499
+ if runs.empty?
500
+ # The interpretive pipeline classifies the raw ""
501
+ # through the rule's value map: the :empty directive
502
+ # (the plain-rule default) binds "" — the attribute is
503
+ # still marked set, which is what the #856 mark is
504
+ # about; :nil binds nil; other directives leave the
505
+ # binding unset.
506
+ instance.value_set_for(attr.name)
507
+ case rule.value_map(:from)[:empty]
508
+ when :nil
509
+ instance.public_send(:"#{attr.name}=", nil)
510
+ when :empty
511
+ instance.public_send(:"#{attr.name}=", "")
512
+ end
513
+ next
514
+ end
515
+
516
+ # Non-collection content attrs hold the joined text
517
+ # (the interpretive path assigns element text, the runs
518
+ # concatenated).
519
+ instance.public_send(:"#{attr.name}=", runs.join)
520
+ when :raw
521
+ raws = raw_strings(value, wire_name)
522
+ next if raws.empty?
523
+
524
+ instance.public_send(:"#{attr.name}=",
525
+ attr.collection? ? raws : raws.first)
526
+ when :custom_method
527
+ elements = deferred_elements(value, wire_name, buckets)
528
+ next if elements.empty?
529
+
530
+ args = attr.collection? ? elements : elements.first
531
+ rule.deserialize(instance, args,
532
+ model_class.attributes(register),
533
+ model_class)
534
+ when :ordered_deferred
535
+ next if node # hydrated natively in children_kwargs
536
+
537
+ results = deferred_elements(value, wire_name, buckets).map do |element|
538
+ attr.cast(element, :xml, register,
539
+ lutaml_parent: instance,
540
+ lutaml_root: instance.lutaml_root || instance)
541
+ end
542
+ next if results.empty?
543
+
544
+ instance.public_send(:"#{attr.name}=",
545
+ attr.collection? ? results : results.first)
546
+ when :wildcard_any
547
+ # map_any_element: every child element no named row
548
+ # claims, in document order, bridged as wrappers — the
549
+ # interpretive pass's contract. The wildcard row's
550
+ # type_tag marks its captures in the walk.
551
+ next unless node
552
+
553
+ claimed = plan[:rows].filter_map do |wr, _wa, _wk, spelling, _wd|
554
+ next if wr.equal?(rule) || wr.name.nil?
555
+
556
+ spelling ? spelling.to_s : wr.name.to_s
557
+ end.uniq
558
+ elements = []
559
+ node.children.each do |child|
560
+ next unless child.is_a?(::Leptris::XML::Element)
561
+ next if claimed.include?(child.name)
562
+
563
+ elements << bridge_element(child)
564
+ end
565
+ next if elements.empty?
566
+
567
+ # The interpretive pass casts each collected element
568
+ # through the attribute: String keeps the wrapper,
569
+ # Serializable types build model instances.
570
+ results = elements.map do |element|
571
+ attr.cast(element, :xml, register,
572
+ lutaml_parent: instance,
573
+ lutaml_root: instance.lutaml_root || instance)
574
+ end
575
+ instance.public_send(
576
+ :"#{attr.name}=",
577
+ attr.collection? ? results : results.first,
578
+ )
579
+ when :polymorphic
580
+ results = deferred_elements(value, wire_name, buckets).map do |element|
581
+ attr.cast(element, :xml, register,
582
+ polymorphic: rule.polymorphic,
583
+ lutaml_parent: instance,
584
+ lutaml_root: instance.lutaml_root || instance)
585
+ end
586
+ next if results.empty?
587
+
588
+ instance.public_send(:"#{attr.name}=",
589
+ attr.collection? ? results : results.first)
590
+ end
591
+ end
592
+ end
593
+
594
+ # Wrapper elements for deferred rows: the ORIGINAL source
595
+ # nodes bridged through moxml's wrapper cache (wrapper
596
+ # construction only, no parse), falling back to a fragment
597
+ # parse of the captured subtree when no node is available.
598
+ # Both lists are document-ordered for the row's name.
599
+ def deferred_elements(value, name, buckets, contested_uri = nil)
600
+ return raw_strings(value, name).map { |raw| fragment_element(raw) } unless buckets
601
+
602
+ nodes = buckets[name]
603
+ return [] unless nodes
604
+
605
+ if contested_uri
606
+ # Contested name: bind only the (URI, local) matches —
607
+ # the type's own mapping namespace is the row identity.
608
+ nodes = buckets[[contested_uri, name]] || []
609
+ end
610
+ nodes.map { |n| bridge_element(n) }
611
+ end
612
+
613
+ def child_type_uri(attr, register)
614
+ type = attr.type(register)
615
+ return nil unless type.is_a?(Class) &&
616
+ type.include?(::Lutaml::Model::Serialize)
617
+
618
+ type.mappings_for(:xml, register)&.namespace_uri
619
+ end
620
+
621
+ def contested_name?(plan, rule)
622
+ plan[:contested_names]&.include?(rule.name.to_s) || false
623
+ end
624
+
625
+ def bridge_element(node)
626
+ Lutaml::Xml::LeptrisElement.new(
627
+ Moxml::Node.wrap(node, bridge_context),
628
+ )
629
+ end
630
+
631
+ def bridge_context
632
+ @bridge_context ||= Moxml::Context.new(:leptris)
633
+ end
634
+
635
+ def route_delegates(delegates, instance)
636
+ delegates.each do |rule, delegate_attr, attr, v|
637
+ target = instance.public_send(rule.delegate)
638
+ unless target
639
+ # the interpretive path instantiates absent delegate
640
+ # targets; mirror it
641
+ target = delegate_attr.type(register).new
642
+ instance.public_send(:"#{rule.delegate}=", target)
643
+ end
644
+ target.public_send(:"#{attr.name}=", v)
645
+ end
646
+ end
647
+
648
+ def delegate_of(plan, rule)
649
+ entry = plan[:rows].find { |r, _, _k, _| r.equal?(rule) }
650
+ entry && entry[4]
651
+ end
652
+
653
+ # Delegate rules hold their values for post-instance routing
654
+ # (the target object must exist first); plain rules land in
655
+ # kwargs directly.
656
+ def assign(kwargs, delegates, delegate, rule, attr, value)
657
+ if delegate
658
+ delegates << [rule, delegate, attr, value]
659
+ else
660
+ kwargs[attr.name.to_sym] = value
661
+ end
662
+ end
663
+
664
+ # Content runs ride the children snapshot: the nil-name
665
+ # entries ARE the :collection run groups (one crossing per
666
+ # node via group_children, none here). The per-group
667
+ # at/count crossings are the drain itself.
668
+ def content_runs(_value, run_children)
669
+ (run_children || []).flat_map do |group|
670
+ Array.new(group.count) { |j| group.at(j).string_value }
671
+ end
672
+ end
673
+
674
+ # Native collection rows echo their producing row's name
675
+ # (leptris 1.9.178).
676
+ def native_collection(value, name)
677
+ value.count.times do |i|
678
+ c = value.at(i)
679
+ next unless c.kind == :collection && c.name == name
680
+
681
+ return Array.new(c.count) { |j| c.at(j).string_value }
682
+ end
683
+ nil
684
+ end
685
+
686
+ def raw_strings(value, name)
687
+ out = []
688
+ value.count.times do |idx|
689
+ child = value.at(idx)
690
+ if child.name == name && child.kind == :raw
691
+ out << child.string_value
692
+ end
693
+ end
694
+ out
695
+ end
696
+
697
+ # Fragment deferral: parse the captured subtree back into a
698
+ # wrapper element. Ancestor namespace context is absent (the
699
+ # compiler only defers on namespace-free model chains).
700
+ def fragment_element(raw)
701
+ Lutaml::Xml::Adapter::LeptrisAdapter.parse(raw).root
702
+ end
703
+
704
+ # Attribute names claimed by exactly one attr row — the only
705
+ # names eligible for #754/#790 lenient binding (multi-claimant
706
+ # names stay exact; per #841 leniency is sole-claimant-only).
707
+ def sole_claimant_names(plan)
708
+ # Frozen with the plan: recomputing the tally per hydration
709
+ # showed in the #876-era profile as Enumerable#find/tally churn.
710
+ plan[:sole_claimants] ||= plan[:attr_rows]
711
+ .map { |rule, _attr, row_name| row_name || rule.name.to_s }.tally
712
+ .select { |_n, c| c == 1 }.keys
713
+ end
714
+
715
+ # Local-name attribute lookup on the source node, qualified
716
+ # spellings included (w:val matches rule "val").
717
+ def lenient_node_attribute(node, local_name)
718
+ return nil unless node.respond_to?(:attributes)
719
+
720
+ node.attributes.each_value do |attr|
721
+ # Leptris::XML::Attr carries the raw (possibly prefixed)
722
+ # name; strip the prefix for the local-name comparison.
723
+ name = attr.name.to_s
724
+ name = name.split(":").last if name.include?(":")
725
+ return attr.value if name == local_name
726
+ end
727
+ nil
728
+ end
729
+
730
+ def group_children(value, row_tags = nil)
731
+ # One crossing per subtree: names/tags/children come back in
732
+ # parallel arrays from leptris_plan_value_children_snapshot.
733
+ # The plan-path version gate (PlanCompiler.compile) already
734
+ # guarantees leptris >= 1.9.273.0.
735
+ names, tags, children = value.children_snapshot
736
+ grouped = {}
737
+ want_tags = !row_tags.nil?
738
+ tagged = want_tags ? {} : nil
739
+ run_children = nil
740
+ names.each_with_index do |name, i|
741
+ if name.nil?
742
+ # Content runs: same snapshot pass — at()/count() per
743
+ # child cost a crossing and a wrapper each.
744
+ (run_children ||= []) << children[i]
745
+ next
746
+ end
747
+
748
+ child = children[i]
749
+ (grouped[name] ||= []) << child
750
+ if want_tags && tags[i] != 0
751
+ (tagged[tags[i]] ||= []) << child
752
+ end
753
+ end
754
+ [grouped, tagged, run_children]
755
+ end
756
+
757
+ # Element children bucketed by local name, document order
758
+ # preserved — the node-side mirror of group_children for
759
+ # ordered-child hydration. Only built when the plan's subtree
760
+ # needs source nodes; namespace-qualified models never get
761
+ # here (the compiler keeps them interpretive).
762
+ # Contested names need (URI, local) node buckets; every other
763
+ # plan hydrates from the name view alone — the qualified keys
764
+ # are one array + hash write per child and measured as an
765
+ # allocation regression on element-heavy corpora (niso gate).
766
+ def element_buckets(node, contested_names = nil)
767
+ buckets = {}
768
+ qualified = contested_names && !contested_names.empty?
769
+ node.children.each do |child|
770
+ next unless child.is_a?(::Leptris::XML::Element)
771
+
772
+ name = child.name
773
+ (buckets[name] ||= []) << child
774
+ if qualified
775
+ uri = child.namespace&.href
776
+ (buckets[[uri, name]] ||= []) << child if uri
777
+ end
778
+ end
779
+ buckets
780
+ end
781
+
782
+ # Selected source nodes for a child row: contested names
783
+ # dispatch by (URI, local); every other row binds the whole
784
+ # name bucket leniently (any qualification). The pair form
785
+ # this replaces allocated a fresh array per row per node on
786
+ # the ordered walk (niso gate).
787
+ def child_selection(buckets, name, child_plan, contested)
788
+ all = buckets && buckets[name]
789
+ return all unless buckets && all && contested
790
+
791
+ tree_ns = child_plan[:tree][:ns]
792
+ exact_uri = tree_ns.is_a?(Hash) ? tree_ns[:exact] : tree_ns
793
+ exact_uri ? (buckets[[exact_uri, name]] || []) : all
794
+ end
795
+
796
+ # Per-(plan, register) child-row tuples, computed once and
797
+ # reused across every node the walk hands this plan: the
798
+ # per-node type lookup, compile hit, child register
799
+ # resolution, and contested flag were each a measurable slice
800
+ # of the ordered-lane allocation profile (niso gate).
801
+ def child_row_plans(plan, register)
802
+ plan[:child_row_memo] ||= {}
803
+ plan[:child_row_memo][register] ||= plan[:rows].map do |rule, attr, kind, _spelling, _delegate, row_type|
804
+ next nil unless CHILD_ROW_KINDS.include?(kind)
805
+
806
+ child_type = row_type || attr.type(register)
807
+ child_plan = PlanCompiler.compile(child_type, register)
808
+ child_register = Lutaml::Model::Register.resolve_for_child(
809
+ child_type, register
810
+ )
811
+ [child_type, child_plan, child_register,
812
+ contested_name?(plan, rule)]
813
+ end
814
+ end
815
+
816
+ # Plan-frozen wire names: rule.name.to_s minted a fresh string
817
+ # per row per node in the hot loop.
818
+ def row_wire_names(plan)
819
+ plan[:row_wire_names] ||= plan[:rows].map do |rule, _attr, _kind, _spelling, _delegate, _row_type|
820
+ rule.name.to_s
821
+ end
822
+ end
823
+ end
824
+ end
825
+ end
826
+ end
827
+ end