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,825 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Lutaml
4
+ module Model
5
+ module Serialize
6
+ # Handles initialization and namespace methods for Serialize::ClassMethods
7
+ #
8
+ # Extracted from serialize.rb to improve code organization.
9
+ # Provides methods for class initialization and namespace handling.
10
+ module Initialization
11
+ # Class-level namespace getter/setter.
12
+ #
13
+ # No-op by default. When XML format is loaded, this is overridden
14
+ # via prepend to provide XML namespace handling.
15
+ #
16
+ # @param _ns_class [Class, nil] Namespace class (handled by format modules)
17
+ # @return [Class, nil] the namespace class
18
+ def namespace(_ns_class = nil)
19
+ @namespace_class
20
+ end
21
+
22
+ # Get the namespace URI for this Model
23
+ #
24
+ # @return [String, nil] the namespace URI
25
+ def namespace_uri
26
+ nil
27
+ end
28
+
29
+ # Get the default namespace prefix for this Model
30
+ #
31
+ # @return [String, nil] the namespace prefix
32
+ def namespace_prefix
33
+ nil
34
+ end
35
+
36
+ # Set the register context for this Model class.
37
+ #
38
+ # This is called by Register#register_model to ensure the class
39
+ # knows its register context for proper instance initialization.
40
+ #
41
+ # @param register_id [Symbol] The register ID
42
+ # @return [void]
43
+ def set_register_context(register_id)
44
+ return if instance_variable_defined?(:@register)
45
+
46
+ @register = register_id
47
+ end
48
+
49
+ # Get or set the default register for this Model class.
50
+ #
51
+ # Override in subclasses to specify a preferred default register context.
52
+ # This allows versioned schemas (e.g., MML v2, v3) to use their own
53
+ # register by default when instances are created without explicit register.
54
+ #
55
+ # @return [Symbol, nil] The default register ID or nil to use Config.default_register
56
+ #
57
+ # @example
58
+ # module Mml
59
+ # class V2Base < Lutaml::Model::Serializable
60
+ # def self.lutaml_default_register
61
+ # :mml_v2
62
+ # end
63
+ # end
64
+ # end
65
+ #
66
+ # class Mml::V2::Math < V2Base
67
+ # # Mml::V2::Math.new uses :mml_v2 by default
68
+ # end
69
+ def lutaml_default_register
70
+ nil
71
+ end
72
+
73
+ # Handle inheritance by copying parent's configuration
74
+ #
75
+ # @param subclass [Class] The inheriting class
76
+ def inherited(subclass)
77
+ super
78
+ subclass.initialize_attrs(self)
79
+ end
80
+
81
+ # Handle inclusion by extending with ClassMethods
82
+ #
83
+ # @param base [Class] The including class
84
+ def included(base)
85
+ base.extend(ClassMethods)
86
+ base.initialize_attrs(self)
87
+ end
88
+
89
+ # Copy-on-write structure status. Two bits per structure
90
+ # (mappings, attributes, choices, registers): 0 = inherited and
91
+ # shared with the source class, 1 = owned and private (safe to
92
+ # mutate in place), 2 = owned but shared with subclasses (fork
93
+ # before mutating so they keep the pre-mutation state).
94
+ LUTAML_COW_STRUCTURES = %i[mappings attributes choices registers].freeze
95
+
96
+ # Initialize class attributes from a source class
97
+ #
98
+ # @param source_class [Class] The source class to copy from
99
+ def initialize_attrs(source_class)
100
+ if source_class.equal?(self)
101
+ # A subclass that says `include Lutaml::Model::Serialize`
102
+ # again re-enters this hook with itself as the source. It
103
+ # already carries the state `inherited` installed, and the
104
+ # eager implementation re-copied that state; here it must
105
+ # survive untouched, so only a brand-new class initializes.
106
+ initialize_empty_attrs if @attributes.nil?
107
+ else
108
+ @mappings = source_class.mappings
109
+ @attributes = source_class.class_attributes
110
+ @choice_attributes = source_class.class_choice_attributes
111
+ @register_records = source_class.register_records
112
+ @lutaml_cow_status = 0
113
+ lutaml_cow_mark_ancestors_shared!(source_class)
114
+ # A choice binds its owning class and stamps itself onto
115
+ # the attribute options, so a subclass must rebind its
116
+ # choices to itself. Models without choices — the vast
117
+ # majority — keep sharing the empty array.
118
+ lutaml_cow_fork!(:choices) if @choice_attributes&.any?
119
+ end
120
+ model(self)
121
+ end
122
+
123
+ def initialize_empty_attrs
124
+ # `Liquefiable` may already have created the mapping store
125
+ # before this class included `Serialize`; that state is the
126
+ # class's own and must survive initialization.
127
+ @mappings ||= {}
128
+ @attributes ||= {}
129
+ @choice_attributes ||= []
130
+ @register_records ||= ::Hash.new do |hash, key|
131
+ hash[key] = { attributes: {}, choice_attributes: [] }
132
+ end
133
+ @lutaml_cow_status = Lutaml::Model::Serialize::Initialization
134
+ .lutaml_cow_status_for(1)
135
+ end
136
+
137
+ # Status value for every structure, encoded per structure
138
+ def self.lutaml_cow_status_for(state)
139
+ LUTAML_COW_STRUCTURES.each_index.sum do |i|
140
+ state << (i * 2)
141
+ end
142
+ end
143
+
144
+ def lutaml_cow_status(structure)
145
+ shift = LUTAML_COW_STRUCTURES.index(structure) * 2
146
+ ((@lutaml_cow_status || 0) >> shift) & 3
147
+ end
148
+
149
+ # Pack one structure's state back into the status word
150
+ def lutaml_cow_set_status!(structure, state)
151
+ shift = LUTAML_COW_STRUCTURES.index(structure) * 2
152
+ @lutaml_cow_status = ((@lutaml_cow_status || 0) & ~(3 << shift)) |
153
+ (state << shift)
154
+ end
155
+
156
+ # The structures this class inherited are about to gain a second
157
+ # referencer (the new subclass). Every ancestor whose current
158
+ # object for a structure is the object being shared must flip
159
+ # from owned-private to owned-shared, or its next in-place
160
+ # mutation would leak into the new subclass.
161
+ def lutaml_cow_mark_ancestors_shared!(source_class)
162
+ LUTAML_COW_STRUCTURES.each do |structure|
163
+ shared = lutaml_cow_structure(structure)
164
+ klass = source_class
165
+ loop do
166
+ if klass.lutaml_cow_structure(structure).equal?(shared) &&
167
+ klass.lutaml_cow_status(structure) == 1
168
+ klass.lutaml_cow_set_status!(structure, 2)
169
+ end
170
+ break unless klass.is_a?(Class)
171
+
172
+ klass = klass.superclass
173
+ break unless klass.include?(Lutaml::Model::Serialize)
174
+ end
175
+ end
176
+ end
177
+
178
+ def lutaml_cow_structure(structure)
179
+ case structure
180
+ when :mappings then @mappings
181
+ when :attributes then @attributes
182
+ when :choices then @choice_attributes
183
+ when :registers then @register_records
184
+ end
185
+ end
186
+
187
+ # Replace a shared structure with a class-owned copy. The copy
188
+ # becomes the snapshot for every existing subclass, which is what
189
+ # keeps post-fork mutations invisible to them (the eager-copy
190
+ # semantics).
191
+ #
192
+ # Public on purpose: code that mutates `mappings`, `attributes`,
193
+ # `choices` or `registers` outside the DSL — sibling classes pruning
194
+ # inherited elements (relaton's Item-header prunes) or importing
195
+ # models — must fork the structure first, or the mutation lands on
196
+ # the object shared with the superclass and every sibling class.
197
+ def lutaml_cow_fork!(structure)
198
+ return if lutaml_cow_status(structure) == 1
199
+
200
+ # The merged attribute view is built from the structures
201
+ # below; a replacement makes any cached merge stale.
202
+ @merged_attributes_cache = nil
203
+ case structure
204
+ when :mappings
205
+ # Entries are shared with the source class as well as the
206
+ # hash itself: a sibling inheriting the same object must
207
+ # not see this class's DSL. Copying every entry here is
208
+ # the lazy equivalent of the eager snapshot the previous
209
+ # implementation took in `inherited`.
210
+ @mappings = Utils.deep_dup(@mappings) || {}
211
+ when :attributes
212
+ @attributes = Utils.deep_dup(@attributes) || {}
213
+ when :choices
214
+ # Choice duplication rebinds Attribute objects through
215
+ # `attributes`, so the attributes fork must land first.
216
+ lutaml_cow_fork!(:attributes)
217
+ @choice_attributes = deep_duplicate_choice_attributes(self)
218
+ when :registers
219
+ @register_records = Utils.deep_dup(@register_records) ||
220
+ ::Hash.new do |hash, key|
221
+ hash[key] = { attributes: {}, choice_attributes: [] }
222
+ end
223
+ end
224
+ lutaml_cow_set_status!(structure, 1)
225
+ end
226
+
227
+ # Return the mapping object a format DSL may mutate. Forking
228
+ # the mappings structure copies every entry, so the object
229
+ # returned here is this class's own.
230
+ def lutaml_cow_mapping_for_dsl!(format)
231
+ lutaml_cow_fork!(:mappings)
232
+ @mappings[format]
233
+ end
234
+
235
+ # Return the register record a format DSL may mutate. The
236
+ # register store is copy-on-write, so write access forks it
237
+ # away from the parent class before handing out the record.
238
+ def register_record_for_dsl!(register_id)
239
+ lutaml_cow_fork!(:registers)
240
+ @register_records[register_id] ||= { attributes: {},
241
+ choice_attributes: [] }
242
+ end
243
+
244
+ # Deep duplicate choice attributes from a source class
245
+ #
246
+ # @param source_class [Class] The source class
247
+ # @return [Array] The duplicated choice attributes
248
+ def deep_duplicate_choice_attributes(source_class, register = nil)
249
+ choice_attrs = Array(source_class.choice_attributes)
250
+ choice_attrs.map do |choice_attr|
251
+ choice_attr.deep_duplicate(self, register)
252
+ end
253
+ end
254
+
255
+ # Get all attributes for this model
256
+ #
257
+ # Merges class-level attributes with register-specific attributes.
258
+ # Memoized per register: this is on the per-element deserialization
259
+ # hot path, and the merged hash is stable until an attribute, import
260
+ # or register record mutates (those clear @merged_attributes_cache).
261
+ #
262
+ # @param register [Symbol, nil] The register context
263
+ # @return [Hash] The attributes hash
264
+ def attributes(register = nil)
265
+ # Cache hit first: a filled entry can only exist after imports
266
+ # were ensured for that register (the fill path below runs
267
+ # ensure_imports! first), and mutations that invalidate the
268
+ # merge clear @merged_attributes_cache. The lookup was walked
269
+ # per rule application (751k per ISO-13849 parse).
270
+ if @register_records&.any?
271
+ register_id = extract_register_id(register)
272
+ cached = (@merged_attributes_cache ||= {})[register_id]
273
+ return cached if cached
274
+
275
+ ensure_imports!(register) if finalized?
276
+ # ensure_imports! may re-entrantly run clear_cache (restrict /
277
+ # import resolution), which nils @merged_attributes_cache —
278
+ # compute the merge first and re-materialize the memo store
279
+ # at write time (#815: standalone to_xml on register-bound
280
+ # models crashed with nil[] here).
281
+ merged = @attributes.merge(@register_records[register_id][:attributes])
282
+ (@merged_attributes_cache ||= {})[register_id] = merged
283
+ else
284
+ ensure_imports!(register) if finalized?
285
+ @attributes
286
+ end
287
+ end
288
+
289
+ # Raw class-level attributes without register merging.
290
+ # Used by initialize_attrs during class inheritance.
291
+ # @return [Hash] The raw attributes hash
292
+ def class_attributes
293
+ @attributes
294
+ end
295
+
296
+ # Raw class-level choice attributes without register merging.
297
+ # Used by initialize_attrs during class inheritance.
298
+ # @return [Array] The raw choice attributes array
299
+ def class_choice_attributes
300
+ @choice_attributes
301
+ end
302
+
303
+ # Get all choice attributes for this model
304
+ #
305
+ # Merges class-level choice attributes with register-specific choice attributes.
306
+ #
307
+ # @param register [Symbol, nil] The register context
308
+ # @return [Array] The choice attributes array
309
+ def choice_attributes(register = nil)
310
+ ensure_imports!(register) if finalized?
311
+ if @register_records&.any?
312
+ @choice_attributes + @register_records[extract_register_id(register)][:choice_attributes]
313
+ else
314
+ @choice_attributes
315
+ end
316
+ end
317
+
318
+ # Ensure all imports are resolved
319
+ #
320
+ # @param register [Symbol, nil] The register context
321
+ def ensure_imports!(register = nil)
322
+ # Bounded re-entry for the resolution chain. Each leg's
323
+ # record_import_attempt tail calls attributes(), which calls
324
+ # back into ensure_imports!; nested passes converge imports
325
+ # whose targets only become resolvable after an earlier leg
326
+ # (so they must not be dropped), but with a permanently
327
+ # pending import the tail re-entered unboundedly and crashed
328
+ # with SystemStackError (#938). Two levels allow one nested
329
+ # convergence pass; deeper re-entry is suppressed per
330
+ # register and the counter unwinds on error.
331
+ register_id = extract_register_id(register)
332
+ (@ensure_imports_depth ||= {})[register_id] ||= 0
333
+ return if @ensure_imports_depth[register_id] >= 2
334
+
335
+ @ensure_imports_depth[register_id] += 1
336
+ begin
337
+ ensure_model_imports!(register)
338
+ ensure_choice_imports!(register)
339
+ ensure_restrict_attributes!(register)
340
+ # Hook for format-specific mapping import resolution.
341
+ # XML overrides this to call mappings[:xml]&.ensure_mappings_imported!(register)
342
+ ensure_format_mapping_imports!(register)
343
+ ensure
344
+ @ensure_imports_depth[register_id] -= 1
345
+ end
346
+ end
347
+
348
+ # Hook for format-specific mapping import resolution.
349
+ # Override in format modules (e.g., XML prepends to resolve XML mapping imports).
350
+ #
351
+ # @param _register [Symbol, nil] The register context
352
+ def ensure_format_mapping_imports!(_register = nil)
353
+ # No-op by default; XML overrides via prepend
354
+ end
355
+
356
+ # Clear all cached data for this model class
357
+ #
358
+ # Centralized caching (Phase 11.5):
359
+ # - Type caches: GlobalContext.resolver
360
+ # - Mapping caches: TransformationRegistry
361
+ # - Transformation caches: TransformationRegistry
362
+ #
363
+ # @param register_id [Symbol, nil] If provided, only clear cache for this specific context
364
+ def clear_cache(register_id = nil)
365
+ # Clear centralized type cache in GlobalContext.resolver
366
+ if defined?(Lutaml::Model::GlobalContext)
367
+ GlobalContext.resolver.clear_cache(register_id)
368
+ end
369
+
370
+ # Clear memoized attribute merge (see .attributes)
371
+ @merged_attributes_cache = nil
372
+ @instantiate_writers = nil
373
+ @instantiate_attr_pairs = nil
374
+
375
+ # Clear per-Attribute type caches (stale entries from GC'd TypeContext objects)
376
+ class_attributes.each_value(&:clear_type_cache)
377
+ @register_records&.each_value do |record|
378
+ record[:attributes]&.each_value(&:clear_type_cache)
379
+ end
380
+
381
+ # Clear centralized mapping and transformation caches
382
+ # (Single Source of Truth - no longer uses instance variables)
383
+ TransformationRegistry.instance.clear
384
+
385
+ # Clear Transform cache (uses class identity as key)
386
+ Transform.invalidate_for(self, register_id)
387
+
388
+ # Clear import resolution guard flags so imports can be re-resolved
389
+ instance_variables.each do |ivar|
390
+ ivar_s = ivar.to_s
391
+ remove_instance_variable(ivar) if ivar_s.start_with?("@_imports_resolved_") ||
392
+ ivar_s == "@_register_methods_defined"
393
+ end
394
+ end
395
+
396
+ # Get or set the model class
397
+ #
398
+ # @param klass [Class, nil] The model class to set
399
+ # @return [Class] The model class
400
+ def model(klass = nil)
401
+ if klass
402
+ @model = klass
403
+ add_custom_handling_methods_to_model(klass)
404
+ else
405
+ @model
406
+ end
407
+ end
408
+
409
+ # Add custom handling methods to a model class
410
+ #
411
+ # @param klass [Class] The model class
412
+ def add_custom_handling_methods_to_model(klass)
413
+ Utils.add_method_if_not_defined(klass,
414
+ :using_default_for) do |attribute_name|
415
+ @using_default ||= {}
416
+ @using_default[attribute_name] = true
417
+ end
418
+
419
+ Utils.add_method_if_not_defined(klass,
420
+ :value_set_for) do |attribute_name|
421
+ @using_default ||= {}
422
+ @using_default[attribute_name] = false
423
+ end
424
+
425
+ Utils.add_method_if_not_defined(klass,
426
+ :values_set_for) do |attribute_names|
427
+ @using_default ||= {}
428
+ attribute_names.each { |name| @using_default[name] = false }
429
+ end
430
+
431
+ Utils.add_method_if_not_defined(klass,
432
+ :using_default?) do |attribute_name|
433
+ @using_default ||= {}
434
+ !!@using_default[attribute_name]
435
+ end
436
+
437
+ # Hook for format-specific model methods (e.g., XML adds ordered, mixed, element_order)
438
+ add_format_specific_model_methods(klass)
439
+ end
440
+
441
+ # Hook for format-specific model methods.
442
+ # XML overrides via FormatConversion prepend to add XML accessors.
443
+ #
444
+ # @param _klass [Class] The model class
445
+ def add_format_specific_model_methods(_klass)
446
+ # No-op by default
447
+ end
448
+
449
+ # Cast a value (pass-through implementation)
450
+ #
451
+ # @param value [Object] The value to cast
452
+ # @return [Object] The same value
453
+ def cast(value)
454
+ value
455
+ end
456
+
457
+ # Whether instances of this class should be registered in the
458
+ # global Store for reference resolution. Defaults to true for
459
+ # backward compatibility. Use `skip_reference_registration` to
460
+ # opt out for classes that never participate in cross-referencing.
461
+ def reference_resolvable?
462
+ return true unless instance_variable_defined?(:@skip_reference_registration)
463
+
464
+ !@skip_reference_registration
465
+ end
466
+
467
+ # Opt out of Store registration for this class.
468
+ # Instances will not be tracked in the global Store, saving
469
+ # memory and registration overhead for classes that are never
470
+ # resolved by reference (no xml_id or similar attributes).
471
+ def skip_reference_registration
472
+ @skip_reference_registration = true
473
+ end
474
+
475
+ # Define a choice constraint
476
+ #
477
+ # @param min [Integer] Minimum number of choices
478
+ # @param max [Integer] Maximum number of choices
479
+ # @param block [Proc] The choice definition block
480
+ def choice(min: 1, max: 1, format: nil, &block)
481
+ lutaml_cow_fork!(:choices)
482
+ @choice_attributes << Choice.new(self, min, max,
483
+ format: format).tap do |c|
484
+ c.instance_eval(&block)
485
+ end
486
+ end
487
+
488
+ # Get the register record for a specific register ID
489
+ #
490
+ # @param register_id [Symbol, nil] The register context
491
+ # @return [Hash, nil] The register record hash or nil
492
+ def register_record(register_id = nil)
493
+ register_records[extract_register_id(register_id)]
494
+ end
495
+
496
+ # Convert register parameter to symbol
497
+ #
498
+ # @param name [Symbol, String, nil] The register name
499
+ # @return [Symbol, nil] The register name as a symbol
500
+ def register(name)
501
+ name&.to_sym
502
+ end
503
+
504
+ # Allocate an instance for deserialization without calling initialize.
505
+ #
506
+ # Skips the expensive initialize_attributes pass (which iterates all
507
+ # attributes to set defaults). The XML mapping pipeline sets values
508
+ # directly via rule.deserialize instead. Uses Hash.new(true) as the
509
+ # default for @using_default so that using_default? returns true for
510
+ # all attributes until value_set_for is called.
511
+ #
512
+ # @param register [Symbol, nil] The register context
513
+ # @return [Object] The allocated instance
514
+ # Walk-side allocation (#1003): the KV walk's instantiation —
515
+ # constructor-equivalent state via the compiled walk seed
516
+ # (defaults resolved, non-defaulted attributes nil) without the
517
+ # per-attribute determine_value walk.
518
+ def allocate_for_walk(register = nil)
519
+ register_id = extract_register_id(register)
520
+ ensure_imports!(register_id) if finalized? && deferred_imports_pending?(register_id)
521
+ # Classes with their own initialize set up internal state the
522
+ # compiled seed cannot know about (SchemaRepository's
523
+ # @parsed_schemas/@namespace_registry/@type_index): construct
524
+ # through the real constructor for them, exactly as the walk
525
+ # did before the compiled seed existed, register included. The
526
+ # seed stays the fast path for classes using the standard
527
+ # initializer.
528
+ return new(lutaml_register: register) if constructs_through_initialize?
529
+
530
+ instance = allocate
531
+ instance.init_walk_state(register_id)
532
+ instance
533
+ end
534
+
535
+ # True when the class does not use Serializable's standard
536
+ # initializer — its initialize is constructor contract, not
537
+ # optional setup, and the compiled walk seed would skip it.
538
+ # (The standard initializer's owner is Serialize::Builder; a
539
+ # class- or parent-defined initialize makes the owner the class.)
540
+ def constructs_through_initialize?
541
+ @constructs_through_initialize ||=
542
+ instance_method(:initialize).owner != Lutaml::Model::Serialize::Builder
543
+ end
544
+
545
+ def allocate_for_deserialization(register = nil)
546
+ register_id = extract_register_id(register)
547
+ # Deferred imports (symbol-form import_model_attributes) must
548
+ # resolve before state defaults compile: the compiled seeding
549
+ # and the raw readers cover the post-import attribute set, and
550
+ # the transform's records already carry the mapping's rules
551
+ # for imported names — CTR's <m:br> parsed before resolution
552
+ # had no reader (#933). The constructor path ensures the same
553
+ # way (initialize_attributes). Guarded: deep object graphs
554
+ # (XSD schema trees) allocate recursively, and the ensure
555
+ # chain's frames per level pushed that recursion past the
556
+ # stack limit — models without pending deferred imports skip
557
+ # it entirely.
558
+ ensure_imports!(register_id) if finalized? && deferred_imports_pending?(register_id)
559
+ # Custom-initialize classes (#1032's twin): their initialize is
560
+ # constructor contract — internal state the compiled seeding
561
+ # cannot know about — so they construct through the real
562
+ # constructor, then carry the parse's register context.
563
+ # Attribute state then goes back to the deserialization
564
+ # markers: the parse reads them to tell an absent element from
565
+ # a value a writer assigned (#922), so constructor-seeded
566
+ # defaults would otherwise count as set and a render_default:
567
+ # false element would be written back out.
568
+ if constructs_through_initialize?
569
+ # (#1059) Run the custom initialize against COMPILED
570
+ # constructor-equivalent state — the walk seed (defaults
571
+ # resolved, non-defaulted attributes nil), not the
572
+ # deserialization seed: constructor bodies branch on
573
+ # truthiness and is_a? checks of plain state, and an
574
+ # UninitializedClass sentinel is truthy, so seeding
575
+ # sentinels here would misfire every convenience-conversion
576
+ # branch (uniword's convert_flat_attributes! constructed
577
+ # wrapper objects per node). The generic attribute walk is
578
+ # still stood down for the run — it would only re-materialize
579
+ # the same defaults the seed already wrote — and #922's
580
+ # finalize then resets attribute state to the deserialization
581
+ # markers, so constructor-seeded defaults do not count as
582
+ # set, exactly as before.
583
+ instance = allocate
584
+ instance.init_walk_state(register_id)
585
+ instance.lutaml_constructor_seeded = true
586
+ instance.send(:initialize)
587
+ instance.lutaml_constructor_seeded = nil
588
+ instance.finalize_deserialization(register_id)
589
+ return instance
590
+ end
591
+ instance = allocate
592
+ instance.finalize_deserialization(register_id)
593
+ instance
594
+ end
595
+
596
+ # Fast bulk constructor for deserialization-heavy callers
597
+ # (native extensions building object trees bottom-up).
598
+ #
599
+ # Allocates without running #initialize and applies each present
600
+ # attribute through its compiled writer, which casts the value
601
+ # and marks it as explicitly set — so defaults, to_hash output,
602
+ # and using_default? behave exactly as if the instance had been
603
+ # produced by from_hash. Values may be primitives or already
604
+ # built instances (instances pass through casting unchanged);
605
+ # absent keys keep their defaults. Unknown keys raise.
606
+ #
607
+ # @param attrs [Hash] attribute names (String or Symbol) to
608
+ # pre-cast values
609
+ # @param register [Symbol, nil] The register context
610
+ # @return [Object] The hydrated instance
611
+ def instantiate(attrs = {}, register = nil)
612
+ instance = allocate_for_deserialization(register)
613
+ register_id = instance.lutaml_register
614
+ attrs_by = attributes(register_id)
615
+ writers = instantiate_writers(register_id)
616
+ raw_readers = instantiate_raw_readers(register_id)
617
+ given = 0
618
+ # Memoized pair array: Hash#each mints a [name, attr] pair
619
+ # per attribute per instance (~5 allocs/instance on
620
+ # hydration-heavy corpora); Array#each reuses its elements.
621
+ instantiate_attr_pairs(register_id).each do |name, attr, str_name|
622
+ next if attr.derived?
623
+
624
+ # Symbol keys hit directly (native-extension callers);
625
+ # string keys fall back with one allocated name.
626
+ key = if attrs.key?(name)
627
+ given += 1
628
+ name
629
+ elsif attrs.key?(str_name)
630
+ given += 1
631
+ str_name
632
+ end
633
+ if key
634
+ instance.public_send(writers[name], attrs[key])
635
+ else
636
+ # Absent keys seed their default explicitly, mirroring
637
+ # initialize_attributes: every mapped attribute ends up
638
+ # set (nil when no default), never left as the
639
+ # uninitialized sentinel — readers and formatters touch
640
+ # absent attributes freely.
641
+ #
642
+ # lutaml-model#922: unless a custom writer already
643
+ # populated it. An earlier kwarg's writer may have
644
+ # assigned this attribute as a side effect (relaton's ICS
645
+ # populates <text> from the Isoics dataset inside code=);
646
+ # the raw state is the truth — still at its initialized
647
+ # marker (sentinel / lazy collection) means unset, and
648
+ # only then is the default seeded. The writer's own
649
+ # value_set_for (inside the compiled writer) already
650
+ # marked it set, so it renders.
651
+ raw = instance.public_send(raw_readers[name])
652
+ unset = raw.nil? ||
653
+ raw.equal?(Lutaml::Model::UninitializedClass.instance) ||
654
+ raw.equal?(Lutaml::Model::Serialize::LAZY_EMPTY_COLLECTION)
655
+ next unless unset
656
+
657
+ default = attr.default_value(register_id, instance)
658
+ if raw.nil? && Lutaml::Model::Utils.uninitialized?(default)
659
+ # The constructor-seeded path (#1059) already wrote nil for
660
+ # non-defaulted attributes and marked them using-default — a
661
+ # nil write through the cast chain here would be pure re-work.
662
+ # (Sentinels and lazy collections fall through: they need the
663
+ # seeding branch.)
664
+ instance.using_default_for(name)
665
+ next
666
+ end
667
+ value = if Lutaml::Model::Utils.uninitialized?(default)
668
+ nil
669
+ else
670
+ attr.cast_value(default, register_id)
671
+ end
672
+ instance.public_send(writers[name], value)
673
+ instance.using_default_for(name)
674
+ end
675
+ end
676
+ reserved = (attrs.key?(:lutaml_register) ? 1 : 0) +
677
+ (attrs.key?("lutaml_register") ? 1 : 0)
678
+ if given + reserved < attrs.size
679
+ known = attrs_by.keys
680
+ unknown = attrs.keys.find { |k| !known.include?(k.to_sym) }
681
+ raise Error, "unknown attribute '#{unknown}' for #{self}"
682
+ end
683
+ instance.clear_mutated_after_parse!
684
+ instance
685
+ end
686
+
687
+ # Writer method symbols for instantiate, memoized per register
688
+ # alongside the attribute merge (cleared with it).
689
+ def instantiate_writers(register_id = nil)
690
+ (@instantiate_writers ||= {})[register_id] ||= attributes(register_id)
691
+ .each_with_object({}) do |(name, _attr), memo|
692
+ memo[name] = :"#{name}="
693
+ end
694
+ end
695
+
696
+ # [name, attr] pairs in attributes order — instantiate's loop
697
+ # iterates this instead of the attributes Hash so the per-call
698
+ # pair array disappears (see the instantiate comment).
699
+ def instantiate_attr_pairs(register_id = nil)
700
+ (@instantiate_attr_pairs ||= {})[register_id] ||=
701
+ attributes(register_id).map do |name, attr|
702
+ # The string name is precomputed beside the symbol: the
703
+ # absent-key fallback (string-keyed callers, from_hash)
704
+ # would otherwise mint `name.to_s` per attribute per
705
+ # instance — one fresh string per absent attribute.
706
+ [name, attr, name.to_s]
707
+ end.freeze
708
+ end
709
+
710
+ # Raw-state reader names, precomputed once per (class, register):
711
+ # instantiating interpolates the reader symbol per absent
712
+ # attribute per instance otherwise — a fresh string + symbol
713
+ # lookup for state that is identical for every instance.
714
+ def instantiate_raw_readers(register_id = nil)
715
+ (@instantiate_raw_readers ||= {})[register_id] ||=
716
+ attributes(register_id).to_h do |name, _|
717
+ [name, :"__lutaml_raw_#{name}"]
718
+ end.freeze
719
+ end
720
+
721
+ # Define register-specific attribute methods on the class itself.
722
+ #
723
+ # Called once per (class, register) combination. Replaces per-instance
724
+ # singleton class allocation with class-level method definitions,
725
+ # preserving Ruby's inline method cache optimization.
726
+ #
727
+ # @param register_id [Symbol] The register ID
728
+ def ensure_register_methods_defined(register_id)
729
+ return if register_id == :default
730
+
731
+ @_register_methods_defined ||= {}
732
+ return if @_register_methods_defined[register_id]
733
+
734
+ reg_record = register_records[register_id]
735
+ return unless reg_record
736
+
737
+ default_attrs = class_attributes || {}
738
+ reg_record_attrs = reg_record[:attributes] || {}
739
+
740
+ reg_record_attrs.each do |name, attr|
741
+ next if default_attrs.key?(name)
742
+ next if method_defined?(name, false)
743
+
744
+ if attr.collection?
745
+ define_collection_register_methods(name)
746
+ else
747
+ define_scalar_register_methods(name)
748
+ end
749
+ end
750
+
751
+ @_register_methods_defined[register_id] = true
752
+ end
753
+
754
+ private
755
+
756
+ # Define getter/setter for a scalar register-specific attribute.
757
+ def define_scalar_register_methods(name)
758
+ define_method(name) do |*args|
759
+ if args.empty?
760
+ instance_variable_get(:"@#{name}")
761
+ else
762
+ public_send(:"#{name}=", args.first)
763
+ args.first
764
+ end
765
+ end
766
+
767
+ define_method(:"#{name}=") do |value|
768
+ value_set_for(name)
769
+ reg_attr = resolve_register_attr(name)
770
+ value = reg_attr.cast_value(value, lutaml_register)
771
+ instance_variable_set(:"@#{name}", value)
772
+ record_mutation(name, value)
773
+ end
774
+ end
775
+
776
+ # Define getter/setter for a collection register-specific attribute.
777
+ def define_collection_register_methods(name)
778
+ define_method(name) do |*args|
779
+ if args.empty?
780
+ # Store the materialized Array instead of discarding it, so
781
+ # `model.items << x` on a register-scoped model reaches the model
782
+ # rather than a throwaway copy.
783
+ materialize_lazy_collection(name)
784
+ else
785
+ value = args.first
786
+ current = instance_variable_get(:"@#{name}")
787
+ current = [] if current.equal?(LAZY_EMPTY_COLLECTION)
788
+ new_value = current.is_a?(Array) ? current + [value] : value
789
+ instance_variable_set(:"@#{name}", new_value)
790
+ record_mutation(name, value)
791
+ value
792
+ end
793
+ end
794
+
795
+ define_method(:"#{name}=") do |value|
796
+ value_set_for(name)
797
+ reg_attr = resolve_register_attr(name)
798
+ value = reg_attr.cast_value(value, lutaml_register)
799
+ current = instance_variable_get(:"@#{name}")
800
+ if current.equal?(LAZY_EMPTY_COLLECTION) &&
801
+ (value.nil? || Lutaml::Model::Utils.uninitialized?(value))
802
+ # Sentinel stays — no allocation for empty collections
803
+ else
804
+ instance_variable_set(:"@#{name}", value)
805
+ end
806
+ record_mutation_collection(name, value)
807
+ end
808
+ end
809
+
810
+ # Extract and normalize register ID with default fallback
811
+ #
812
+ # Resolution order:
813
+ # 1. Explicit register parameter
814
+ # 2. Class's lutaml_default_register (for versioned schemas)
815
+ # 3. Global Config.default_register
816
+ #
817
+ # @param register [Symbol, String, nil] The register identifier
818
+ # @return [Symbol] The normalized register ID
819
+ def extract_register_id(register)
820
+ register&.to_sym || lutaml_default_register || Lutaml::Model::Config.default_register
821
+ end
822
+ end
823
+ end
824
+ end
825
+ end