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,239 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Opal has no `weakref` stdlib; runtime_compatibility.rb provides a stub.
4
+ require "weakref" unless Lutaml::Model.opal?
5
+
6
+ module Lutaml
7
+ module Model
8
+ class Store
9
+ # Compact dead index entries once a class bucket grows past this size.
10
+ COMPACTION_THRESHOLD = 1000
11
+
12
+ # Once the threshold is exceeded, only compact every Nth subsequent
13
+ # register call. Amortises the O(N) prune over N inserts so
14
+ # register stays O(1) per call rather than O(N) per call (O(N^2)
15
+ # cumulatively for the class).
16
+ COMPACTION_INTERVAL = 1000
17
+
18
+ WeakBucket = if Lutaml::Model.opal?
19
+ # Opal has neither WeakRef nor ObjectSpace::WeakMap; documents in
20
+ # the browser are small, so strong references are the fallback.
21
+ ::Hash
22
+ else
23
+ # CRuby: WeakMap holds keys weakly with zero Ruby-level
24
+ # allocation per insert and no per-object finalizer — the WeakRef
25
+ # approach allocated one finalizer-registering object per
26
+ # instance (lutaml-model#695) and dominated GC cycles on
27
+ # instance-heavy parses.
28
+ ::ObjectSpace::WeakMap
29
+ end
30
+
31
+ class << self
32
+ def instance
33
+ @instance ||= new
34
+ end
35
+
36
+ # lutaml-model#808: Ruby 3.3's GC has a WeakMap-mark hazard under
37
+ # heavy insert churn (freed slot dereferenced at wmap mark time).
38
+ # Registration is only ever consumed by `ref:` resolution — when
39
+ # no Reference-typed attribute exists anywhere, nothing can
40
+ # resolve, so registration is skipped entirely and the WeakMap
41
+ # stays quiet. Set the first time an attribute with a Reference
42
+ # type is defined.
43
+ # Not memoized `||=` — the setter flips it to true for the
44
+ # process lifetime and reads must see that.
45
+ def reference_types_in_use?
46
+ @reference_types_in_use ? true : false
47
+ end
48
+
49
+ def reference_types_in_use!
50
+ @reference_types_in_use = true
51
+ end
52
+
53
+ def reset!
54
+ @instance = new
55
+ end
56
+
57
+ def register(object)
58
+ return unless reference_types_in_use?
59
+
60
+ instance.register(object)
61
+ end
62
+
63
+ def resolve(model_class, reference_key, reference_value)
64
+ instance.resolve(model_class, reference_key, reference_value)
65
+ end
66
+
67
+ def clear
68
+ instance.clear
69
+ end
70
+
71
+ def store
72
+ instance.store
73
+ end
74
+ end
75
+
76
+ def initialize
77
+ # WeakMap-based buckets: value presence marks liveness, no
78
+ # per-instance allocation (lutaml-model#695).
79
+ @store = ::Hash.new { |hash, key| hash[key] = WeakBucket.new }
80
+ # Nested index: { model_key => { reference_key => { value => object } } }
81
+ # Grouped by model_key so register only iterates this class's own indices.
82
+ @index = {}
83
+ @inserts_since_compaction = ::Hash.new(0)
84
+ @compaction_count = 0
85
+ end
86
+
87
+ def register(object)
88
+ model_key = object.class.to_s
89
+ @store[model_key][object] = true
90
+ @inserts_since_compaction[model_key] += 1
91
+
92
+ compact_if_needed(model_key)
93
+
94
+ update_existing_indices(object, model_key)
95
+ end
96
+
97
+ def resolve(model_class, reference_key, reference_value)
98
+ model_key = model_class.to_s
99
+ model_indices = @index[model_key]
100
+
101
+ unless model_indices&.key?(reference_key)
102
+ model_indices = ensure_model_index(model_key)
103
+ build_index(model_indices, model_key, reference_key)
104
+ end
105
+
106
+ entry = model_indices[reference_key][reference_value]
107
+ return nil unless entry
108
+
109
+ obj = dereference(entry)
110
+ model_indices[reference_key].delete(reference_value) unless obj
111
+ obj
112
+ end
113
+
114
+ def live_objects(model_key)
115
+ bucket = @store[model_key]
116
+ return [] unless bucket
117
+
118
+ live_objects_for(bucket)
119
+ end
120
+
121
+ def clear
122
+ @store = ::Hash.new { |hash, key| hash[key] = WeakBucket.new }
123
+ @index = {}
124
+ @inserts_since_compaction = ::Hash.new(0)
125
+ @compaction_count = 0
126
+ end
127
+
128
+ def store
129
+ @store.transform_values { |refs| live_objects_for(refs) }
130
+ end
131
+
132
+ def refs_for(model_key)
133
+ LiveView.new(self, model_key)
134
+ end
135
+
136
+ def inserts_since_compaction
137
+ @inserts_since_compaction
138
+ end
139
+
140
+ def compaction_count
141
+ @compaction_count
142
+ end
143
+
144
+ def index_entry_count(model_key)
145
+ @index[model_key]&.sum { |_reference_key, entries| entries.size } || 0
146
+ end
147
+
148
+ private
149
+
150
+ def ensure_model_index(model_key)
151
+ @index[model_key] ||= {}
152
+ end
153
+
154
+ # Build index for a (model_class, reference_key) pair by scanning
155
+ # live instances. Index values hold WeakRefs: the index must not
156
+ # pin objects (only the rare classes with resolved reference keys
157
+ # pay this; the per-instance bucket stays allocation-free WeakMap).
158
+ def build_index(model_indices, model_key, reference_key)
159
+ entries = model_indices[reference_key] = {}
160
+ each_live(model_key) do |obj|
161
+ value = obj.public_send(reference_key)
162
+ entries[value] = WeakRef.new(obj) if value
163
+ end
164
+ end
165
+
166
+ # Update indices that already exist for this model class only.
167
+ # O(K) where K = number of reference keys indexed for this class,
168
+ # not O(N×K) across all classes.
169
+ def update_existing_indices(object, model_key)
170
+ model_indices = @index[model_key]
171
+ return unless model_indices
172
+
173
+ model_indices.each_key do |reference_key|
174
+ value = object.public_send(reference_key)
175
+ model_indices[reference_key][value] = WeakRef.new(object) if value
176
+ end
177
+ end
178
+
179
+ def dereference(entry)
180
+ entry.__getobj__ if entry.weakref_alive?
181
+ rescue WeakRef::RefError
182
+ nil
183
+ end
184
+
185
+ def compact_if_needed(model_key)
186
+ return unless @inserts_since_compaction[model_key] >= COMPACTION_INTERVAL
187
+
188
+ @inserts_since_compaction[model_key] = 0
189
+ @compaction_count += 1
190
+ prune_index(model_key)
191
+ end
192
+
193
+ def prune_index(model_key)
194
+ model_indices = @index[model_key]
195
+ return unless model_indices
196
+
197
+ model_indices.delete_if do |_reference_key, entries|
198
+ entries.delete_if do |_value, ref|
199
+ !ref.weakref_alive?
200
+ rescue WeakRef::RefError
201
+ true
202
+ end
203
+ entries.empty?
204
+ end
205
+ end
206
+
207
+ def each_live(model_key, &block)
208
+ @store[model_key]&.each_key(&block)
209
+ end
210
+
211
+ def live_objects_for(bucket)
212
+ # WeakMap#each_key requires a block on CRuby; WeakMap#each
213
+ # yields key/value pairs, and Hash buckets enumerate the same
214
+ # way (value is `true` for WeakMap, the object for the Opal
215
+ # fallback keyed by object identity).
216
+ bucket.map { |key, _value| key }
217
+ end
218
+
219
+ # Array-shaped live view over a class's WeakMap bucket, for
220
+ # specs/debugging (refs_for used to expose the raw array).
221
+ class LiveView
222
+ include Enumerable
223
+
224
+ def initialize(store, model_key)
225
+ @store = store
226
+ @model_key = model_key
227
+ end
228
+
229
+ def each(&block)
230
+ @store.live_objects(@model_key).each(&block)
231
+ end
232
+
233
+ def size
234
+ @store.live_objects(@model_key).size
235
+ end
236
+ end
237
+ end
238
+ end
239
+ end
@@ -0,0 +1,40 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Backward compatibility - provides Lutaml::Model::Toml namespace with helper methods
4
+
5
+ module Lutaml
6
+ module Model
7
+ module Toml
8
+ Lutaml::Model::RuntimeCompatibility.define_native_aliases(
9
+ self,
10
+ TeptrisAdapter: "::Lutaml::Toml::Adapter::TeptrisAdapter",
11
+ TomlibAdapter: "::Lutaml::Toml::Adapter::TomlibAdapter",
12
+ TomlRbAdapter: "::Lutaml::Toml::Adapter::TomlRbAdapter",
13
+ )
14
+ Document = ::Lutaml::Toml::Adapter::Document
15
+ Mapping = ::Lutaml::Toml::Adapter::Mapping
16
+ MappingRule = ::Lutaml::Toml::Adapter::MappingRule
17
+ Transform = ::Lutaml::Toml::Adapter::Transform
18
+
19
+ def self.detect_toml_adapter
20
+ return nil if Lutaml::Model.opal?
21
+
22
+ # teptris 0.2.12+ parses ~3x and dumps ~8x faster than tomlib
23
+ # and ships prebuilts for every platform (mingw-ucrt restored
24
+ # in 0.2.4+) — native TOML on Windows retires the tomlib
25
+ # segfault workaround (previously pure-Ruby toml-rb only).
26
+ return :teptris if Lutaml::Model::Utils.safe_load("teptris", :Teptris)
27
+
28
+ # tomlib segfaults on Windows when parsing invalid TOML
29
+ if !Lutaml::Model::RuntimeCompatibility.windows? &&
30
+ Lutaml::Model::Utils.safe_load("tomlib", :Tomlib)
31
+ return :tomlib
32
+ end
33
+
34
+ return :toml_rb if Lutaml::Model::Utils.safe_load("toml-rb", :TomlRb)
35
+
36
+ nil
37
+ end
38
+ end
39
+ end
40
+ end
@@ -0,0 +1,5 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Backward compatibility stub.
4
+ # XmlTransform has been replaced by Lutaml::Xml::ModelTransform.
5
+ # This file is no longer loaded by the framework.
@@ -0,0 +1,229 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Lutaml
4
+ module Model
5
+ class Transform
6
+ # Maximum number of cached Transform instances before eviction.
7
+ # Covers most OOXML/ISO schemas with ~1000+ classes and multiple registers.
8
+ MAX_CACHE_SIZE = 2048
9
+
10
+ # The (lane, context, register) memo lives in a shared constant,
11
+ # not in class-level ivars: KeyValue::Transform subclasses this
12
+ # class, and inherited class methods run with the subclass as
13
+ # self — ivar state forked per subclass, and clear_cache! on the
14
+ # base class never reached the subclass's copy (stale compiled
15
+ # plans across register resets). The lane is part of the key:
16
+ # each transform class compiles format-specific rules, so a KV
17
+ # transform and the base one must never answer for each other.
18
+ class TransformCache
19
+ attr_reader :size
20
+
21
+ def initialize
22
+ @entries = {}
23
+ @size = 0
24
+ end
25
+
26
+ # Nested memo, not an array key: the hot path is one lookup per
27
+ # parsed node and the key array was that lookup's only
28
+ # allocation (60k arrays on a 6k-node corpus).
29
+ def fetch_or_store(lane, context, register)
30
+ by_context = @entries[lane]
31
+ by_register = by_context&.[](context)
32
+ return by_register[register] if by_register&.key?(register)
33
+
34
+ by_register = ((@entries[lane] ||= {})[context] ||= {})
35
+ transform = yield
36
+ by_register[register] = transform
37
+ @size += 1
38
+ transform
39
+ end
40
+
41
+ def evict_half_if_full
42
+ return unless @size >= MAX_CACHE_SIZE
43
+
44
+ drop = @size / 2
45
+ @entries.each do |lane, by_context|
46
+ by_context.each do |ctx, by_register|
47
+ break if drop <= 0
48
+
49
+ drop -= by_register.size
50
+ by_context.delete(ctx)
51
+ end
52
+ @entries.delete(lane) if by_context.empty?
53
+ break if drop <= 0
54
+ end
55
+ @size = @entries.sum { |_, by_context| by_context.sum { |_, br| br.size } }
56
+ end
57
+
58
+ def invalidate(context, register = nil)
59
+ @entries.each_value do |by_context|
60
+ if register
61
+ by_register = by_context[context]
62
+ next unless by_register&.delete(register)
63
+
64
+ @size -= 1
65
+ by_context.delete(context) if by_register.empty?
66
+ else
67
+ removed = by_context.delete(context)
68
+ @size -= removed.size if removed
69
+ end
70
+ end
71
+ end
72
+
73
+ def clear
74
+ @entries.clear
75
+ @size = 0
76
+ end
77
+ end
78
+
79
+ TRANSFORM_CACHE = TransformCache.new
80
+
81
+ def self.data_to_model(context, data, format, options = {})
82
+ register = options[:register] || Lutaml::Model::Config.default_register
83
+ transform = cached_transform(context, register, options[:mappings])
84
+ transform.data_to_model(data, format, options)
85
+ end
86
+
87
+ def self.model_to_data(context, model, format, options = {})
88
+ register = model.lutaml_register if model.is_a?(Lutaml::Model::Serialize)
89
+ register ||= Lutaml::Model::Config.default_register
90
+ transform = cached_transform(context, register, options[:mappings])
91
+ transform.model_to_data(model, format, options)
92
+ end
93
+
94
+ # An explicit mapping (#176 `mapping:` profiles / `mappings:` seam)
95
+ # gets a dedicated transform so per-instance compiled state (walk
96
+ # plans, serialize plans) never mixes with the base mapping's.
97
+ def self.cached_transform(context, register, mappings = nil)
98
+ return override_transform(context, register, mappings) if mappings
99
+
100
+ TRANSFORM_CACHE.evict_half_if_full
101
+ TRANSFORM_CACHE.fetch_or_store(self, context, register) do
102
+ new(context, register)
103
+ end
104
+ end
105
+
106
+ def self.override_transform(context, register, mappings)
107
+ @override_transform_cache ||= {}
108
+ cache_key = [context, register, mappings.object_id]
109
+ entry = @override_transform_cache[cache_key]
110
+ return entry if entry
111
+
112
+ evict_override_if_needed if @override_transform_cache.size >= MAX_CACHE_SIZE
113
+ @override_transform_cache[cache_key] = new(context, register, mappings)
114
+ end
115
+
116
+ def self.evict_override_if_needed
117
+ keys = @override_transform_cache.keys.first(@override_transform_cache.size / 2)
118
+ keys.each { |k| @override_transform_cache.delete(k) }
119
+ end
120
+ private_class_method :evict_override_if_needed
121
+
122
+ def self.clear_cache!
123
+ TRANSFORM_CACHE.clear
124
+ @override_transform_cache&.clear
125
+ end
126
+
127
+ def self.cache_size
128
+ TRANSFORM_CACHE.size
129
+ end
130
+
131
+ def self.invalidate_for(context, register = nil)
132
+ TRANSFORM_CACHE.invalidate(context, register)
133
+ end
134
+
135
+ attr_reader :context, :lutaml_register
136
+
137
+ def initialize(context, register = nil, mappings_override = nil)
138
+ @context = context
139
+ @lutaml_register = register || Lutaml::Model::Config.default_register
140
+ @lutaml_mapping_override = mappings_override
141
+ end
142
+
143
+ def attributes
144
+ context.attributes(lutaml_register)
145
+ end
146
+
147
+ def model_class
148
+ @context.model
149
+ end
150
+
151
+ def data_to_model(data, options = {})
152
+ raise NotImplementedError,
153
+ "#{self.class.name} must implement `data_to_model`."
154
+ end
155
+
156
+ def model_to_data(model, options = {})
157
+ raise NotImplementedError,
158
+ "#{self.class.name} must implement `model_to_data`."
159
+ end
160
+
161
+ protected
162
+
163
+ def apply_value_map(value, value_map, attr)
164
+ return attr.apply_value_map(value, value_map) if attr
165
+
166
+ # Attribute-less dispatch for custom-method-only rules. Mirrors
167
+ # Attribute#apply_value_map for the options that need no attribute
168
+ # info: :nil -> nil and :omitted -> uninitialized. A typed :empty needs
169
+ # an Attribute (a crash case pre-consolidation), so the value passes
170
+ # through unchanged.
171
+ key = if value.nil? then :nil
172
+ elsif Utils.empty?(value) then :empty
173
+ elsif Utils.uninitialized?(value) then :omitted
174
+ end
175
+ return value unless key
176
+
177
+ case value_map[key]
178
+ when :nil then nil
179
+ when :empty then value
180
+ else Lutaml::Model::UninitializedClass.instance
181
+ end
182
+ end
183
+
184
+ def mappings_for(format, register = nil)
185
+ return @lutaml_mapping_override if @lutaml_mapping_override
186
+
187
+ context.mappings_for(format, register)
188
+ end
189
+
190
+ def defined_mappings_for(format)
191
+ context.mappings[format]
192
+ end
193
+
194
+ def valid_rule?(rule, attribute)
195
+ attribute || rule.custom_methods[:from]
196
+ end
197
+
198
+ def attribute_for_rule(rule)
199
+ return attributes[rule.to] unless rule.delegate
200
+
201
+ attributes[rule.delegate].type(lutaml_register).attributes[rule.to]
202
+ end
203
+
204
+ def register_accessor_methods_for(object, register)
205
+ klass = object.class
206
+ Utils.add_method_if_not_defined(klass, :lutaml_register) do
207
+ @lutaml_register
208
+ end
209
+ Utils.add_method_if_not_defined(klass, :lutaml_register=) do |value|
210
+ @lutaml_register = value
211
+ end
212
+ object.lutaml_register = register
213
+ end
214
+
215
+ def root_and_parent_assignment(instance, options)
216
+ root_and_parent_accessor_methods_for(instance)
217
+ return unless options.key?(:lutaml_parent) && options.key?(:lutaml_root)
218
+
219
+ instance.lutaml_root = options[:lutaml_root] || options[:lutaml_parent]
220
+ instance.lutaml_parent = options[:lutaml_parent]
221
+ end
222
+
223
+ def root_and_parent_accessor_methods_for(instance)
224
+ Utils.add_accessor_if_not_defined(instance.class, :lutaml_parent)
225
+ Utils.add_accessor_if_not_defined(instance.class, :lutaml_root)
226
+ end
227
+ end
228
+ end
229
+ end
@@ -0,0 +1,89 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Lutaml
4
+ module Model
5
+ # Abstract base class for format-specific transformations.
6
+ #
7
+ # A Transformation converts a model instance into a format-specific
8
+ # intermediate representation (like XmlElement) without triggering
9
+ # type resolution or imports during the transformation process.
10
+ #
11
+ # Transformations are pre-compiled at class definition time and frozen
12
+ # to prevent modifications. They contain all necessary information
13
+ # (compiled rules, namespaces, etc.) for transforming instances.
14
+ #
15
+ # @abstract Subclasses must implement {#transform} and {#compile_rules}
16
+ class Transformation
17
+ # @return [Class] The model class this transformation applies to
18
+ attr_reader :model_class
19
+
20
+ # @return [Symbol] The format (:xml, :json, :yaml, etc.)
21
+ attr_reader :format
22
+
23
+ # @return [Register, nil] The register used for type resolution
24
+ attr_reader :register
25
+
26
+ # @return [Array<CompiledRule>] Pre-compiled transformation rules
27
+ attr_reader :compiled_rules
28
+
29
+ # Initialize a new transformation
30
+ #
31
+ # @param model_class [Class] The model class to transform
32
+ # @param mapping_dsl [Mapping, nil] The mapping DSL to compile
33
+ # @param format [Symbol] The format (:xml, :json, :yaml, etc.)
34
+ # @param register [Register, nil] The register for type resolution
35
+ def initialize(model_class, mapping_dsl, format, register)
36
+ @model_class = model_class
37
+ @format = format
38
+ @register = register
39
+ @compiled_rules = compile_rules(mapping_dsl)
40
+ after_compile
41
+ freeze
42
+ end
43
+
44
+ # Hook for format subclasses to derive rule-set-level data after
45
+ # compilation, before the transformation is frozen and shared.
46
+ def after_compile; end
47
+
48
+ # Transform a model instance into format-specific representation
49
+ #
50
+ # @abstract Subclasses must implement this method
51
+ # @param model_instance [Object] The model instance to transform
52
+ # @param options [Hash] Format-specific options
53
+ # @return [Object] Format-specific intermediate representation
54
+ # @raise [NotImplementedError] if not implemented by subclass
55
+ def transform(model_instance, options = {})
56
+ raise NotImplementedError,
57
+ "#{self.class}#transform must be implemented"
58
+ end
59
+
60
+ # Collect all namespaces used in this transformation
61
+ #
62
+ # This method traverses compiled rules recursively to collect
63
+ # all namespace classes, enabling namespace declaration planning
64
+ # without triggering type resolution.
65
+ #
66
+ # @return [Array<Class>] Array of XmlNamespace classes
67
+ def all_namespaces
68
+ namespaces = []
69
+ compiled_rules.each do |rule|
70
+ namespaces.concat(rule.all_namespaces)
71
+ end
72
+ namespaces.uniq
73
+ end
74
+
75
+ private
76
+
77
+ # Compile mapping DSL into pre-compiled rules
78
+ #
79
+ # @abstract Subclasses must implement this method
80
+ # @param mapping_dsl [Mapping, nil] The mapping DSL to compile
81
+ # @return [Array<CompiledRule>] Array of compiled rules
82
+ # @raise [NotImplementedError] if not implemented by subclass
83
+ def compile_rules(mapping_dsl)
84
+ raise NotImplementedError,
85
+ "#{self.class}#compile_rules must be implemented"
86
+ end
87
+ end
88
+ end
89
+ end
@@ -0,0 +1,55 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Lutaml
4
+ module Model
5
+ # Abstract base class for transformation builders.
6
+ #
7
+ # Implements the Builder Pattern for creating format-specific transformations.
8
+ # This satisfies the Open/Closed Principle: open for extension, closed for
9
+ # modification.
10
+ #
11
+ # To add a new serialization format:
12
+ # 1. Create a subclass of TransformationBuilder
13
+ # 2. Implement the `build` class method
14
+ # 3. Register with TransformationRegistry.register_builder(format, builder)
15
+ #
16
+ # @example Creating a custom builder
17
+ # class ProtobufTransformationBuilder < TransformationBuilder
18
+ # def self.build(model_class, mapping, format, register)
19
+ # Protobuf::Transformation.new(model_class, mapping, format, register)
20
+ # end
21
+ # end
22
+ #
23
+ # TransformationRegistry.register_builder(:protobuf, ProtobufTransformationBuilder)
24
+ #
25
+ # @abstract Subclasses must implement {build}
26
+ class TransformationBuilder
27
+ # Build a transformation instance for the given format.
28
+ #
29
+ # @abstract Subclasses must implement this method
30
+ # @param model_class [Class] The model class
31
+ # @param mapping [Mapping] The resolved mapping
32
+ # @param format [Symbol] The format symbol
33
+ # @param register [Register, nil] The register for type resolution
34
+ # @return [Transformation] The transformation instance
35
+ # @raise [NotImplementedError] if not implemented by subclass
36
+ def self.build(model_class, mapping, format, register)
37
+ raise NotImplementedError,
38
+ "#{self.class}.build must be implemented"
39
+ end
40
+
41
+ # Check if this builder can handle the given format.
42
+ #
43
+ # Default implementation checks the FORMATS constant.
44
+ # Subclasses can override for more complex logic.
45
+ #
46
+ # @param format [Symbol] The format to check
47
+ # @return [Boolean] true if this builder handles the format
48
+ def self.handles?(format)
49
+ return false unless const_defined?(:FORMATS, false)
50
+
51
+ const_get(:FORMATS, false).include?(format)
52
+ end
53
+ end
54
+ end
55
+ end