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,1002 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Lutaml
4
+ module Xml
5
+ module Schema
6
+ # XSD Schema generation for XML models
7
+ #
8
+ # Generates W3C XML Schema (XSD) from LutaML model classes.
9
+ # Supports namespace declarations, type definitions, and nested models.
10
+ class XsdSchema
11
+ # Include shared methods from model schema
12
+ include Lutaml::Model::Schema::SharedMethods
13
+ extend Lutaml::Model::Schema::SharedMethods
14
+
15
+ # The XSD vocabulary namespace, routed through the project's namespace
16
+ # object so the declared prefix and every emitted prefix stay in sync.
17
+ # W3c::XsNamespace binds "xs" (matching the built-in xs:-prefixed type
18
+ # references) and opts out of the W3C-reserved-prefix warning.
19
+ def self.xsd_ns
20
+ @xsd_ns ||= Lutaml::Xml::W3c::XsNamespace.new
21
+ end
22
+
23
+ # Qualify an XSD structure element name with the bound prefix, so the
24
+ # prefix used on emitted elements always matches the declared xmlns.
25
+ def self.qn(local)
26
+ "#{xsd_ns.prefix}:#{local}"
27
+ end
28
+
29
+ # Emit an XSD structure element (<xs:local ...>) through the builder.
30
+ def self.xs(xml, local, attrs = nil, &block)
31
+ if attrs
32
+ xml.public_send(qn(local), attrs, &block)
33
+ else
34
+ xml.public_send(qn(local), &block)
35
+ end
36
+ end
37
+
38
+ # Whether a prefix can appear in emitted QNames: present and not the
39
+ # reserved XSD vocabulary prefix.
40
+ def self.usable_prefix?(prefix)
41
+ !prefix.nil? && !prefix.empty? && prefix != xsd_ns.prefix
42
+ end
43
+
44
+ # Per-generation namespace context threaded through the generate_*
45
+ # methods: the schema's target namespace URI and the prefix that
46
+ # qualifies named-type references into it.
47
+ Context = Struct.new(:target_prefix, :target_uri)
48
+
49
+ # The prefix of the schema's target namespace, or nil when the schema
50
+ # has no target namespace (named types then live in no-namespace and
51
+ # their references stay unprefixed). Never returns the reserved "xs".
52
+ def self.target_ns_prefix(xml_mapping)
53
+ prefix =
54
+ if xml_mapping&.namespace_class
55
+ xml_mapping.namespace_prefix ||
56
+ xml_mapping.namespace_class.prefix_default
57
+ elsif xml_mapping&.namespace_uri
58
+ xml_mapping.namespace_prefix
59
+ end
60
+
61
+ prefix if usable_prefix?(prefix)
62
+ end
63
+
64
+ # Qualify a named-type reference with the given prefix so it resolves
65
+ # to the namespace the type is defined in. Built-in refs (which already
66
+ # carry a prefix, e.g. "xs:string") and no-namespace schemas (prefix
67
+ # nil) are returned unchanged.
68
+ def self.qualify_type_ref(type_name, prefix)
69
+ return type_name if prefix.nil? || type_name.nil?
70
+ return type_name if type_name.include?(":")
71
+
72
+ "#{prefix}:#{type_name}"
73
+ end
74
+
75
+ # The prefix a named-type reference should carry. A foreign model's
76
+ # type lives in its own namespace, so the ref uses that namespace's
77
+ # prefix; a model in the target namespace (same URI or none) is defined
78
+ # in this schema, so the ref uses the target prefix.
79
+ def self.nested_ref_prefix(nested_mapping, ctx)
80
+ ns_class = nested_mapping&.namespace_class
81
+ return ctx.target_prefix unless ns_class
82
+ return ctx.target_prefix if ns_class.uri == ctx.target_uri
83
+
84
+ prefix = ns_class.prefix_default
85
+ usable_prefix?(prefix) ? prefix : ctx.target_prefix
86
+ end
87
+
88
+ def self.generate(klass, options = {})
89
+ register = extract_register_from(klass)
90
+ # A mapping profile (#176) generates the schema of its own
91
+ # projection; the base mapping remains the default.
92
+ xml_mapping = if options[:mapping]
93
+ klass.serialization_mapping_for(:xml,
94
+ options[:mapping])
95
+ else
96
+ klass.mappings_for(:xml)
97
+ end
98
+
99
+ # Validate XSD types unless explicitly skipped
100
+ validate_xsd_types!(klass, register) unless options[:skip_validation]
101
+
102
+ # Use Builder with adapter from options or config
103
+ adapter_type = options[:adapter] || Lutaml::Model::Config.xml_adapter_type || :nokogiri
104
+
105
+ schema_builder = Builder.new(
106
+ adapter_type: adapter_type,
107
+ options: { encoding: "UTF-8" },
108
+ ) do |xml|
109
+ generate_schema(xml, klass, xml_mapping, register, options)
110
+ end
111
+
112
+ schema_builder.to_xml(options)
113
+ end
114
+
115
+ # Classify an XSD type name into one of three categories
116
+ #
117
+ # @param type_name [String] The XSD type name to classify
118
+ # @param klass [Class] The model class being processed
119
+ # @param register [Register] The register for type resolution
120
+ # @return [Symbol] :builtin, :custom, :unresolvable, or :unknown
121
+ def self.classify_xsd_type(type_name, klass, register)
122
+ return :builtin if BuiltinTypes.builtin?(type_name)
123
+
124
+ # Custom type - check if resolvable
125
+ if type_name && !type_name.start_with?("xs:")
126
+ return :custom if type_resolvable?(type_name, klass, register)
127
+
128
+ return :unresolvable
129
+ end
130
+
131
+ :unknown
132
+ end
133
+
134
+ # Check if a custom XSD type can be resolved in the model hierarchy
135
+ #
136
+ # @param type_name [String] The custom type name to resolve
137
+ # @param klass [Class] The model class being processed
138
+ # @param register [Register] The register for type resolution
139
+ # @return [Boolean] true if the type can be resolved
140
+ def self.type_resolvable?(type_name, klass, register)
141
+ # Search in nested model attributes
142
+ klass.attributes.each_value do |attr|
143
+ attr_type = attr.type(register)
144
+ next unless attr_type <= Lutaml::Model::Serialize
145
+
146
+ nested_mapping = attr_type.mappings_for(:xml)
147
+ return true if nested_mapping&.type_name_value == type_name
148
+ end
149
+
150
+ false
151
+ end
152
+
153
+ # Validate all XSD types referenced by the model
154
+ #
155
+ # @param klass [Class] The model class to validate
156
+ # @param register [Register] The register for type resolution
157
+ # @raise [UnresolvableTypeError] if any types cannot be resolved
158
+ def self.validate_xsd_types!(klass, register, seen = Set.new)
159
+ # Cycle guard: recursive models (A -> B -> A) would otherwise recurse
160
+ # forever. A class already being validated needs no re-validation.
161
+ return unless seen.add?(klass)
162
+
163
+ errors = []
164
+
165
+ klass.attributes.each do |name, attr|
166
+ attr_type = attr.type(register)
167
+
168
+ # Validate Type::Value xsd_type
169
+ if attr_type.is_a?(Class) && attr_type < Lutaml::Model::Type::Value
170
+ type_name = attr_type.xsd_type
171
+ classification = classify_xsd_type(type_name, klass, register)
172
+
173
+ if classification == :unresolvable
174
+ errors << "Attribute '#{name}' uses unresolvable xsd_type '#{type_name}'. " \
175
+ "Custom types must be defined as LutaML Type::Value or Model classes."
176
+ end
177
+ end
178
+
179
+ # Recursively validate nested models
180
+ if attr_type <= Lutaml::Model::Serialize
181
+ begin
182
+ validate_xsd_types!(attr_type, register, seen)
183
+ rescue Lutaml::Model::UnresolvableTypeError => e
184
+ errors << "In nested model #{attr_type.name}: #{e.message}"
185
+ end
186
+ end
187
+ end
188
+
189
+ if errors.any?
190
+ raise Lutaml::Model::UnresolvableTypeError,
191
+ errors.join("\n")
192
+ end
193
+ end
194
+
195
+ def self.generate_schema(xml, klass, xml_mapping, register, options)
196
+ skip_validation = options[:skip_validation]
197
+
198
+ # Bind the XSD vocabulary namespace to the "xs" prefix (via the
199
+ # namespace object, not a hardcoded string) so the xs:-prefixed type
200
+ # references and the prefixed structure elements are both declared.
201
+ schema_attrs = { xsd_ns.attr_name.to_sym => xsd_ns.uri }
202
+ schema_attrs.merge!(target_namespace_attrs(xml_mapping))
203
+ target_uri = schema_attrs[:targetNamespace]
204
+
205
+ referenced = referenced_namespaces(klass, register, target_uri)
206
+
207
+ # Named-type references into the target namespace need a usable
208
+ # prefix; synthesise a non-colliding one when the namespace class
209
+ # declares none.
210
+ target_prefix = target_ns_prefix(xml_mapping)
211
+ if target_uri && target_prefix.nil?
212
+ target_prefix = synthesize_target_prefix(referenced)
213
+ schema_attrs[:"xmlns:#{target_prefix}"] = target_uri
214
+ end
215
+
216
+ declare_referenced_namespaces!(schema_attrs, referenced, target_uri,
217
+ skip_validation)
218
+
219
+ ctx = Context.new(target_prefix, target_uri)
220
+
221
+ xs(xml, "schema", schema_attrs) do
222
+ # Explicit imports declared on the root's XmlNamespace class.
223
+ imported_uris = Set.new
224
+ if xml_mapping.namespace_class
225
+ imported_uris = generate_imports(xml, xml_mapping.namespace_class)
226
+ generate_includes(xml, xml_mapping.namespace_class)
227
+ end
228
+
229
+ generate_referenced_imports(xml, referenced, target_uri,
230
+ imported_uris)
231
+
232
+ if xml_mapping.documentation_text || xml_mapping.namespace_class&.documentation
233
+ generate_annotation(xml, xml_mapping)
234
+ end
235
+
236
+ element_name = if has_explicit_xml_mapping?(klass, xml_mapping)
237
+ xml_mapping.element_name || xml_mapping.root_element
238
+ end
239
+
240
+ type_name = xml_mapping.type_name_value
241
+
242
+ # Generate XSD based on three patterns:
243
+ # Pattern 1: element only -> inline anonymous complexType
244
+ # Pattern 2: type_name only -> named complexType (no element)
245
+ # Pattern 3: both element and type_name -> element + named complexType
246
+
247
+ # A mapping profile (#176) is a complete projection:
248
+ # attributes its mapping does not claim stay outside the
249
+ # generated schema.
250
+ skip_unmapped = !options[:mapping].nil?
251
+
252
+ if element_name && type_name
253
+ xs(xml, "element",
254
+ { name: element_name,
255
+ type: qualify_type_ref(type_name, target_prefix) })
256
+ generate_complex_type(xml, klass, type_name, register,
257
+ xml_mapping, ctx: ctx,
258
+ skip_unmapped: skip_unmapped)
259
+ elsif type_name && !element_name
260
+ generate_complex_type(xml, klass, type_name, register,
261
+ xml_mapping, ctx: ctx,
262
+ skip_unmapped: skip_unmapped)
263
+ else
264
+ # Use class name as fallback element name if not specified
265
+ elem_name = element_name || klass.name
266
+ xs(xml, "element", { name: elem_name }) do
267
+ generate_complex_type_content(xml, klass, register, xml_mapping,
268
+ ctx: ctx,
269
+ skip_unmapped: skip_unmapped)
270
+ end
271
+ end
272
+
273
+ generate_nested_type_definitions(xml, klass, register, ctx: ctx)
274
+ end
275
+ end
276
+
277
+ # targetNamespace, form defaults, and the target xmlns declaration,
278
+ # derived from the root mapping's namespace configuration.
279
+ def self.target_namespace_attrs(xml_mapping)
280
+ attrs = {}
281
+
282
+ if xml_mapping.namespace_class
283
+ ns = xml_mapping.namespace_class
284
+ attrs[:targetNamespace] = ns.uri
285
+ attrs[:elementFormDefault] = ns.element_form_default.to_s
286
+ attrs[:attributeFormDefault] = ns.attribute_form_default.to_s
287
+ attrs[:version] = ns.version if ns.version
288
+
289
+ prefix = xml_mapping.namespace_prefix || ns.prefix_default
290
+ attrs[:"xmlns:#{prefix}"] = ns.uri if usable_prefix?(prefix)
291
+ elsif xml_mapping.namespace_uri
292
+ # Legacy: namespace URI without XmlNamespace class
293
+ attrs[:targetNamespace] = xml_mapping.namespace_uri
294
+ attrs[:elementFormDefault] = "unqualified"
295
+ attrs[:attributeFormDefault] = "unqualified"
296
+
297
+ if usable_prefix?(xml_mapping.namespace_prefix)
298
+ attrs[:"xmlns:#{xml_mapping.namespace_prefix}"] =
299
+ xml_mapping.namespace_uri
300
+ end
301
+ end
302
+
303
+ attrs
304
+ end
305
+
306
+ # A synthetic prefix for a target namespace that declares none,
307
+ # avoiding every prefix claimed by a referenced namespace.
308
+ def self.synthesize_target_prefix(referenced)
309
+ taken = (referenced[:foreign_models] + referenced[:type_values])
310
+ .filter_map(&:prefix_default)
311
+ candidate = "tns"
312
+ suffix = 0
313
+ candidate = "tns#{suffix += 1}" while taken.include?(candidate)
314
+ candidate
315
+ end
316
+
317
+ # Declare xmlns:<prefix> for every namespace this schema references.
318
+ # Foreign model namespaces are strict: an unusable prefix or a prefix
319
+ # collision always raises (the emitted QNames would resolve to the
320
+ # wrong namespace), while a missing schema_location raises unless
321
+ # skip_validation downgrades it to a warning (the output stays
322
+ # structurally correct, only the import is unresolvable).
323
+ # Type::Value namespaces are declared best-effort (their xsd_type
324
+ # references are emitted verbatim).
325
+ def self.declare_referenced_namespaces!(schema_attrs, referenced, target_uri, skip_validation)
326
+ referenced[:foreign_models].each do |ns_class|
327
+ # An unusable or colliding prefix makes emitted QNames resolve to
328
+ # the wrong namespace — never recoverable, even under
329
+ # skip_validation.
330
+ error = foreign_prefix_error(ns_class, schema_attrs, target_uri)
331
+ raise Lutaml::Model::Error, error if error
332
+
333
+ # A missing schema_location leaves the import unresolvable but the
334
+ # output structurally correct — recoverable under skip_validation.
335
+ unless ns_class.schema_location
336
+ error = missing_schema_location_error(ns_class)
337
+ raise Lutaml::Model::Error, error unless skip_validation
338
+
339
+ warn "[Lutaml::Model] WARN: #{error} " \
340
+ "(skip_validation: emitting best-effort output)"
341
+ end
342
+
343
+ schema_attrs[:"xmlns:#{ns_class.prefix_default}"] = ns_class.uri
344
+ end
345
+
346
+ referenced[:type_values].each do |ns_class|
347
+ prefix = ns_class.prefix_default
348
+ next unless usable_prefix?(prefix)
349
+
350
+ # A prefix bound to two different namespaces emits QNames that
351
+ # resolve to the wrong one — the same unrecoverable collision the
352
+ # foreign path raises on, so raise here too rather than silently
353
+ # keeping the first binding.
354
+ error = prefix_collision_error(prefix, ns_class.uri, schema_attrs)
355
+ raise Lutaml::Model::Error, error if error
356
+
357
+ schema_attrs[:"xmlns:#{prefix}"] = ns_class.uri
358
+ end
359
+ end
360
+
361
+ # Why a foreign namespace's prefix cannot be used in this schema's
362
+ # QNames, or nil when it can.
363
+ def self.foreign_prefix_error(ns_class, schema_attrs, target_uri)
364
+ prefix = ns_class.prefix_default
365
+ unless usable_prefix?(prefix)
366
+ schema_desc = target_uri ? "the '#{target_uri}'" : "this no-namespace"
367
+ return "XSD generation: foreign namespace '#{ns_class.uri}' " \
368
+ "needs a usable prefix_default (not nil/empty/'xs') to " \
369
+ "be referenced from #{schema_desc} schema."
370
+ end
371
+
372
+ prefix_collision_error(prefix, ns_class.uri, schema_attrs)
373
+ end
374
+
375
+ # The collision message when +prefix+ is already bound to a different
376
+ # namespace than +uri+ in +schema_attrs+, or nil when there is no
377
+ # conflict.
378
+ def self.prefix_collision_error(prefix, uri, schema_attrs)
379
+ existing = schema_attrs[:"xmlns:#{prefix}"]
380
+ return unless existing && existing != uri
381
+
382
+ "XSD generation: namespace prefix '#{prefix}' is bound " \
383
+ "to two different namespaces (#{existing} and #{uri}). " \
384
+ "Give them distinct prefixes."
385
+ end
386
+
387
+ def self.missing_schema_location_error(ns_class)
388
+ "XSD generation: foreign namespace '#{ns_class.uri}' needs a " \
389
+ "schema_location so its imported types can be resolved."
390
+ end
391
+
392
+ # <xs:import> for every referenced foreign namespace, deduped by URI
393
+ # against the explicit imports already emitted.
394
+ def self.generate_referenced_imports(xml, referenced, target_uri, imported_uris)
395
+ (referenced[:foreign_models] + referenced[:type_values]).each do |ns_class|
396
+ next if ns_class.uri == target_uri
397
+ next unless imported_uris.add?(ns_class.uri)
398
+
399
+ emit_import(xml, ns_class)
400
+ end
401
+ end
402
+
403
+ # Emit <xs:import> for each namespace the root's XmlNamespace class
404
+ # explicitly declares. Returns the Set of imported URIs so the tree
405
+ # import loop can dedupe against them.
406
+ def self.generate_imports(xml, namespace_class)
407
+ imported = Set.new
408
+ return imported unless namespace_class.imports&.any?
409
+
410
+ namespace_class.imports.each do |imported_ns|
411
+ next unless imported.add?(imported_ns.uri)
412
+
413
+ emit_import(xml, imported_ns)
414
+ end
415
+
416
+ imported
417
+ end
418
+
419
+ # Emit a single <xs:import> for a namespace class, with schemaLocation
420
+ # when the class declares one.
421
+ def self.emit_import(xml, ns_class)
422
+ import_attrs = { namespace: ns_class.uri }
423
+ if ns_class.schema_location
424
+ import_attrs[:schemaLocation] = ns_class.schema_location
425
+ end
426
+ xs(xml, "import", import_attrs)
427
+ end
428
+
429
+ def self.generate_includes(xml, namespace_class)
430
+ return unless namespace_class.includes&.any?
431
+
432
+ namespace_class.includes.each do |schema_location|
433
+ xs(xml, "include", { schemaLocation: schema_location })
434
+ end
435
+ end
436
+
437
+ def self.generate_annotation(xml, xml_mapping)
438
+ xs(xml, "annotation") do
439
+ doc_text = xml_mapping.documentation_text
440
+ doc_text ||= xml_mapping.namespace_class&.documentation if xml_mapping.namespace_class
441
+
442
+ xs(xml, "documentation", doc_text) if doc_text
443
+ end
444
+ end
445
+
446
+ def self.generate_nested_type_definitions(xml, klass, register, ctx:, seen: nil)
447
+ # Cycle guard, seeded with the root class (already defined by
448
+ # generate_schema) so it is never redefined via a back-reference.
449
+ seen ||= Set[klass]
450
+
451
+ klass.attributes.each_value do |attr|
452
+ attr_type = attr.type(register)
453
+ next unless attr_type <= Lutaml::Model::Serialize
454
+
455
+ nested_mapping = attr_type.mappings_for(:xml)
456
+
457
+ # Skip models this document does not emit — checked before the cycle
458
+ # guard so an unemitted reference never consumes the model's slot and
459
+ # masks an emitted reference elsewhere. A collection of a type_name-
460
+ # less model is a placeholder; an imported foreign type is defined in
461
+ # its own schema document. A foreign model without a type_name is
462
+ # inlined here, so we still descend to define the types it references.
463
+ next if collection_placeholder?(attr, nested_mapping)
464
+ next if imported_foreign_type?(nested_mapping, ctx.target_uri)
465
+ next unless seen.add?(attr_type)
466
+
467
+ nested_type_name = nested_mapping&.type_name_value
468
+ if nested_type_name
469
+ generate_complex_type(xml, attr_type, nested_type_name, register,
470
+ nested_mapping, ctx: ctx)
471
+ end
472
+
473
+ generate_nested_type_definitions(xml, attr_type, register,
474
+ ctx: ctx, seen: seen)
475
+ end
476
+ end
477
+
478
+ # Whether a nested model's mapping belongs to a namespace other than the
479
+ # schema's target namespace. A model with no namespace belongs to the
480
+ # target schema (not foreign).
481
+ def self.foreign_namespace?(mapping, target_uri)
482
+ ns_class = mapping&.namespace_class
483
+ return false unless ns_class
484
+
485
+ ns_class.uri != target_uri
486
+ end
487
+
488
+ # Whether a nested model is referenced across a schema-document boundary:
489
+ # it lives in a foreign namespace AND exposes a named type, so it is
490
+ # referenced by a prefixed QName and resolved through an <xs:import>.
491
+ # A foreign model WITHOUT a type_name has no named type to reference, so
492
+ # generate_elements inlines it into this document — it is not a boundary,
493
+ # and both the namespace walk and the type-definition walk must descend
494
+ # into it rather than treat it as imported.
495
+ def self.imported_foreign_type?(mapping, target_uri)
496
+ foreign_namespace?(mapping, target_uri) &&
497
+ !mapping.type_name_value.nil?
498
+ end
499
+
500
+ # Whether a nested model is emitted only as a placeholder: a collection
501
+ # of a type_name-less model renders as `<element name="item"
502
+ # type="xs:string"/>`, so the model's own content is never inlined or
503
+ # referenced. This document therefore neither declares its namespaces
504
+ # nor defines its nested types — the walkers must not descend into it.
505
+ def self.collection_placeholder?(attr, mapping)
506
+ attr.collection? && mapping&.type_name_value.nil?
507
+ end
508
+
509
+ def self.generate_complex_type_content(xml, klass, register,
510
+ xml_mapping, ctx:, skip_unmapped: false)
511
+ xs(xml, "complexType") do
512
+ if klass.attributes.any?
513
+ xs(xml, "sequence") do
514
+ generate_elements(xml, klass, register, xml_mapping, ctx: ctx,
515
+ skip_unmapped: skip_unmapped)
516
+ end
517
+ end
518
+ if xml_mapping
519
+ generate_attributes(xml, klass, register,
520
+ xml_mapping)
521
+ end
522
+ end
523
+ end
524
+
525
+ def self.generate_complex_type(xml, klass, type_name, register,
526
+ xml_mapping = nil, ctx:, skip_unmapped: false)
527
+ xs(xml, "complexType", { name: type_name }) do
528
+ if klass.attributes.any?
529
+ xs(xml, "sequence") do
530
+ generate_elements(xml, klass, register, xml_mapping, ctx: ctx,
531
+ skip_unmapped: skip_unmapped)
532
+ end
533
+ end
534
+ generate_attributes(xml, klass, register, xml_mapping)
535
+ end
536
+ end
537
+
538
+ def self.generate_elements(xml, klass, register, xml_mapping, ctx:,
539
+ skip_unmapped: false)
540
+ klass.attributes.each do |name, attr|
541
+ next if xml_mapping && attr_is_xml_attribute?(xml_mapping, name)
542
+
543
+ # Find the mapping rule for this attribute
544
+ mapping_rule = xml_mapping&.find_element(name)
545
+ next if skip_unmapped && xml_mapping && mapping_rule.nil?
546
+
547
+ attr_type = attr.type(register)
548
+
549
+ if attr_type <= Lutaml::Model::Serialize
550
+ # Nested model - check if it has a type_name for reference
551
+ nested_mapping = attr_type.mappings_for(:xml)
552
+ nested_type_name = nested_mapping&.type_name_value
553
+
554
+ if attr.collection?
555
+ # Collection of models
556
+ element_attrs = { name: name.to_s }
557
+ element_attrs[:minOccurs] = "0"
558
+ element_attrs[:maxOccurs] = "unbounded"
559
+
560
+ if nested_type_name
561
+ # Reference named type by its owning namespace's prefix
562
+ element_attrs[:type] = qualify_type_ref(
563
+ nested_type_name,
564
+ nested_ref_prefix(nested_mapping, ctx),
565
+ )
566
+ xs(xml, "element", element_attrs)
567
+ else
568
+ # Inline anonymous complexType
569
+ xs(xml, "element", element_attrs) do
570
+ xs(xml, "complexType") do
571
+ xs(xml, "sequence") do
572
+ xs(xml, "element",
573
+ { name: "item", type: get_xsd_type(attr_type) })
574
+ end
575
+ end
576
+ end
577
+ end
578
+ elsif nested_type_name
579
+ # Single nested model - reference by its owning namespace prefix
580
+ xs(xml, "element",
581
+ { name: name.to_s,
582
+ type: qualify_type_ref(
583
+ nested_type_name,
584
+ nested_ref_prefix(nested_mapping, ctx),
585
+ ) })
586
+ else
587
+ # Inline anonymous complexType
588
+ xs(xml, "element", { name: name.to_s }) do
589
+ generate_complex_type_content(xml, attr_type, register, nil,
590
+ ctx: ctx)
591
+ end
592
+ end
593
+ else
594
+ # Value type
595
+ xsd_type = get_attribute_xsd_type(attr, attr_type, register,
596
+ mapping_rule)
597
+
598
+ if attr.collection?
599
+ # Collection of simple types
600
+ element_attrs = { name: name.to_s }
601
+ element_attrs[:minOccurs] = "0"
602
+ element_attrs[:maxOccurs] = "unbounded"
603
+
604
+ xs(xml, "element", element_attrs) do
605
+ xs(xml, "complexType") do
606
+ xs(xml, "sequence") do
607
+ emit_value_element(xml, { name: "item" }, xsd_type,
608
+ attr_type, attr)
609
+ end
610
+ end
611
+ end
612
+ else
613
+ # Simple element
614
+ element_attrs = build_element_attributes(name, xsd_type, attr,
615
+ xml_mapping, name)
616
+ emit_value_element(xml, element_attrs, xsd_type, attr_type,
617
+ attr)
618
+ end
619
+ end
620
+ end
621
+ end
622
+
623
+ def self.generate_attributes(xml, klass, register, xml_mapping)
624
+ return unless xml_mapping
625
+
626
+ xml_mapping.attributes.each do |rule|
627
+ attr = klass.attributes[rule.to]
628
+ next unless attr
629
+
630
+ attr_type = attr.type(register)
631
+ xsd_type = get_attribute_xsd_type(attr, attr_type, register, rule)
632
+ emit_xsd_attribute(xml, attr, rule, xsd_type, attr_type)
633
+ end
634
+ end
635
+
636
+ # Emit an `xs:attribute`, inlining an `xs:restriction` when the attribute
637
+ # is a constrained value type (its `type=` moves into the restriction
638
+ # base) and/or an annotation when the mapping carries documentation.
639
+ def self.emit_xsd_attribute(xml, attr, rule, xsd_type, attr_type)
640
+ facets = effective_facets(attr, attr_type)
641
+ restricted = facets.any?
642
+
643
+ attr_attrs = { name: rule.name }
644
+ attr_attrs[:type] = xsd_type unless restricted
645
+ attr_attrs[:use] = "required" if attr.options[:required]
646
+ attr_attrs[:form] = rule.form.to_s if rule.form
647
+
648
+ return xs(xml, "attribute", attr_attrs) unless restricted || rule.documentation
649
+
650
+ xs(xml, "attribute", attr_attrs) do
651
+ if rule.documentation
652
+ xs(xml, "annotation") do
653
+ xs(xml, "documentation", rule.documentation)
654
+ end
655
+ end
656
+ emit_restriction(xml, xsd_type, facets, attr_type) if restricted
657
+ end
658
+ end
659
+
660
+ def self.effective_facets(attr, attr_type)
661
+ return {} unless attr_type.is_a?(Class) &&
662
+ attr_type < Lutaml::Model::Type::Value
663
+
664
+ attr.effective_restriction_facets(attr_type)
665
+ end
666
+
667
+ def self.emit_value_element(xml, attrs, xsd_type, attr_type, attr)
668
+ facets = effective_facets(attr, attr_type)
669
+ if facets.any?
670
+ xs(xml, "element", attrs.except(:type)) do
671
+ emit_restriction(xml, xsd_type, facets, attr_type)
672
+ end
673
+ else
674
+ xs(xml, "element", attrs.merge(type: xsd_type))
675
+ end
676
+ end
677
+
678
+ def self.emit_restriction(xml, base, facets, type)
679
+ xs(xml, "simpleType") do
680
+ xs(xml, "restriction", base: base) do
681
+ emit_restriction_facets(xml, facets, type)
682
+ end
683
+ end
684
+ end
685
+
686
+ def self.emit_restriction_facets(xml, facets, type)
687
+ emit_bound(xml, :minExclusive, facets[:min_exclusive], type)
688
+ emit_bound(xml, :minInclusive, facets[:min_inclusive], type)
689
+ emit_bound(xml, :maxExclusive, facets[:max_exclusive], type)
690
+ emit_bound(xml, :maxInclusive, facets[:max_inclusive], type)
691
+ emit_facet(xml, :totalDigits, facets[:total_digits])
692
+ emit_facet(xml, :fractionDigits, facets[:fraction_digits])
693
+ emit_facet(xml, :length, facets[:length])
694
+ emit_facet(xml, :minLength, facets[:min_length])
695
+ emit_facet(xml, :maxLength, facets[:max_length])
696
+ Array(facets[:enumeration]).each do |value|
697
+ emit_facet(xml, :enumeration, lexical_value(type, value))
698
+ end
699
+ emit_facet(xml, :whiteSpace, facets[:white_space])
700
+ patterns = Array(facets[:pattern])
701
+ if patterns.size > 1
702
+ raise Lutaml::Model::Error,
703
+ "Cannot export #{patterns.size} conjunctive patterns on " \
704
+ "#{type} to a single xs:restriction: sibling xs:pattern " \
705
+ "facets are alternatives (OR), and XSD cannot express " \
706
+ "conjunction (AND) without nested restriction derivation, " \
707
+ "which is not yet supported."
708
+ end
709
+ patterns.each { |re| emit_facet(xml, :pattern, pattern_value(re)) }
710
+ end
711
+
712
+ def self.emit_bound(xml, element, value, type)
713
+ emit_facet(xml, element, lexical_value(type, value)) unless value.nil?
714
+ end
715
+
716
+ def self.emit_facet(xml, element, value)
717
+ return if value.nil?
718
+
719
+ xml.public_send(qn(element), value: value.to_s)
720
+ end
721
+
722
+ def self.pattern_value(regexp)
723
+ reject_unsupported_regex_flags!(regexp)
724
+ source = strip_ruby_anchors(regexp.source)
725
+ reject_invalid_xsd_pattern!(regexp, source)
726
+ source
727
+ end
728
+
729
+ def self.reject_unsupported_regex_flags!(regexp)
730
+ return if regexp.options.nobits?(UNSUPPORTED_XSD_REGEX_FLAGS)
731
+
732
+ raise Lutaml::Model::Error,
733
+ "Cannot export pattern #{regexp.inspect} to xs:pattern: " \
734
+ "the i/m/x flags are not expressible in XSD's regexp subset."
735
+ end
736
+
737
+ def self.strip_ruby_anchors(source)
738
+ source = strip_leading_anchor(source)
739
+ strip_trailing_anchor(source)
740
+ end
741
+
742
+ def self.strip_leading_anchor(source)
743
+ return source[1..] if source.start_with?("^")
744
+
745
+ run = leading_backslash_run(source)
746
+ return source unless run.odd? && source[run] == "A"
747
+
748
+ # Keep the escaped-pair backslashes; drop the anchor's `\A`.
749
+ source[0, run - 1] + source[(run + 1)..]
750
+ end
751
+
752
+ def self.strip_trailing_anchor(source)
753
+ last = source[-1]
754
+ before = source.length - 1
755
+ if ["z", "Z"].include?(last) &&
756
+ trailing_backslash_run(source, before).odd?
757
+ return source[0...-2]
758
+ end
759
+ if last == "$" && trailing_backslash_run(source, before).even?
760
+ return source[0...-1]
761
+ end
762
+
763
+ source
764
+ end
765
+
766
+ def self.leading_backslash_run(source)
767
+ run = 0
768
+ run += 1 while source[run] == "\\"
769
+ run
770
+ end
771
+
772
+ def self.trailing_backslash_run(source, pos)
773
+ run = 0
774
+ i = pos - 1
775
+ while i >= 0 && source[i] == "\\"
776
+ run += 1
777
+ i -= 1
778
+ end
779
+ run
780
+ end
781
+
782
+ def self.raise_inexpressible_pattern!(regexp, detail)
783
+ raise Lutaml::Model::Error,
784
+ "Cannot export pattern #{regexp.inspect} to xs:pattern: " \
785
+ "it is not expressible in XSD's regexp subset (#{detail})."
786
+ end
787
+
788
+ def self.reject_invalid_xsd_pattern!(regexp, source)
789
+ return unless defined?(::Nokogiri::XML::Schema)
790
+
791
+ probe = <<~XSD
792
+ <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
793
+ <xs:simpleType name="p">
794
+ <xs:restriction base="xs:string">
795
+ <xs:pattern value="#{xsd_escape(source)}"/>
796
+ </xs:restriction>
797
+ </xs:simpleType>
798
+ </xs:schema>
799
+ XSD
800
+ schema = ::Nokogiri::XML::Schema(probe)
801
+ return if schema.errors.empty?
802
+
803
+ raise_inexpressible_pattern!(regexp, schema.errors.first.message)
804
+ rescue ::Nokogiri::XML::SyntaxError => e
805
+ raise_inexpressible_pattern!(regexp, e.message)
806
+ end
807
+
808
+ UNSUPPORTED_XSD_REGEX_FLAGS =
809
+ Regexp::IGNORECASE | Regexp::MULTILINE | Regexp::EXTENDED
810
+
811
+ def self.xsd_escape(text)
812
+ text.gsub("&", "&amp;").gsub("<", "&lt;").gsub('"', "&quot;")
813
+ end
814
+
815
+ def self.lexical_value(type, value)
816
+ type.serialize(type.cast(value))
817
+ end
818
+
819
+ def self.attr_is_xml_attribute?(xml_mapping, attr_name)
820
+ xml_mapping.attributes.any? { |rule| rule.to == attr_name }
821
+ end
822
+
823
+ def self.build_element_attributes(name, xsd_type, attr, xml_mapping,
824
+ attr_name)
825
+ attrs = { name: name.to_s, type: xsd_type }
826
+
827
+ # Handle collection cardinality
828
+ if attr.collection?
829
+ range = attr.resolved_collection
830
+ if range
831
+ attrs[:minOccurs] = range.min.to_s
832
+ attrs[:maxOccurs] =
833
+ range.end.infinite? ? "unbounded" : range.max.to_s
834
+ else
835
+ attrs[:minOccurs] = "0"
836
+ attrs[:maxOccurs] = "unbounded"
837
+ end
838
+ end
839
+
840
+ # Add form attribute from mapping rule if present
841
+ if xml_mapping
842
+ rule = xml_mapping.find_element(attr_name)
843
+ attrs[:form] = rule.form.to_s if rule&.form
844
+ attrs[:annotation] = rule.documentation if rule&.documentation
845
+ end
846
+
847
+ attrs
848
+ end
849
+
850
+ def self.has_explicit_xml_mapping?(klass, xml_mapping)
851
+ return true unless xml_mapping.root_element
852
+
853
+ base_name = Lutaml::Model::Utils.base_class_name(klass)
854
+ xml_mapping.root_element != base_name
855
+ end
856
+
857
+ def self.get_attribute_xsd_type(attr, attr_type, register,
858
+ _mapping_rule = nil)
859
+ if attr.union?
860
+ raise Lutaml::Model::UnionSchemaUnsupportedError.new(attr.name,
861
+ "XSD")
862
+ end
863
+
864
+ # 1. Check for deprecated attribute-level xsd_type override
865
+ return attr.options[:xsd_type] if attr.options[:xsd_type]
866
+
867
+ # 2. Check if type has xsd_type method (Type-level)
868
+ if attr_type.is_a?(Class) && attr_type < Lutaml::Model::Type::Value
869
+ # Special handling for Reference type
870
+ if attr_type == Lutaml::Model::Type::Reference
871
+ target_xsd_type = get_target_xsd_type(attr, register)
872
+ return attr_type.xsd_type(target_xsd_type)
873
+ end
874
+
875
+ return attr_type.xsd_type
876
+ end
877
+
878
+ # 3. Fall back to default mapping
879
+ get_xsd_type(attr_type)
880
+ end
881
+
882
+ # Namespaces referenced by THIS schema document, collected by walking
883
+ # the model tree from the root class (structural, no instance needed).
884
+ # The walk stops at foreign-model boundaries: a foreign model's type is
885
+ # imported — defined in its own schema document — so namespaces used
886
+ # only inside it are that document's concern, not this one's.
887
+ #
888
+ # @return [Hash] :foreign_models — namespace classes of directly
889
+ # referenced foreign models (their type refs are prefixed QNames
890
+ # resolved through an import); :type_values — namespace classes
891
+ # declared by Type::Value attribute types (imported so their
892
+ # verbatim xsd_type references can resolve). Both deduped by class.
893
+ def self.referenced_namespaces(klass, register, target_uri, seen = Set.new)
894
+ result = { foreign_models: [], type_values: [] }
895
+ return result unless klass.is_a?(::Class) && seen.add?(klass)
896
+
897
+ klass.attributes.each_value do |attr|
898
+ type_class = attr.type(register)
899
+ next unless type_class
900
+
901
+ if type_class <= Lutaml::Model::Serialize
902
+ mapping = type_class.mappings_for(:xml)
903
+ if imported_foreign_type?(mapping, target_uri)
904
+ result[:foreign_models] << mapping.namespace_class
905
+ elsif collection_placeholder?(attr, mapping)
906
+ # Placeholder collection: its content is never emitted, so it
907
+ # contributes no namespaces to this document.
908
+ next
909
+ else
910
+ nested = referenced_namespaces(type_class, register,
911
+ target_uri, seen)
912
+ result[:foreign_models].concat(nested[:foreign_models])
913
+ result[:type_values].concat(nested[:type_values])
914
+ end
915
+ else
916
+ ns = get_namespace_info(type_class)[:class]
917
+ if ns.is_a?(::Class) && ns < Lutaml::Xml::Namespace
918
+ result[:type_values] << ns
919
+ end
920
+ end
921
+ end
922
+
923
+ result[:foreign_models].uniq!
924
+ result[:type_values].uniq!
925
+ result
926
+ end
927
+
928
+ # Namespace information for a Type::Value class (the only kind the
929
+ # namespace walk queries — nested models are handled structurally by
930
+ # referenced_namespaces). Returns {} for anything else.
931
+ def self.get_namespace_info(klass)
932
+ return {} unless klass.is_a?(::Class)
933
+
934
+ if defined?(Lutaml::Model::Type::Value) &&
935
+ klass <= Lutaml::Model::Type::Value
936
+ return get_type_namespace_info(klass)
937
+ end
938
+
939
+ {}
940
+ end
941
+
942
+ class << self
943
+ private
944
+
945
+ # Get namespace info from Type class (Type::Value)
946
+ def get_type_namespace_info(klass)
947
+ ns = klass.is_a?(Class) && klass <= Lutaml::Model::Type::Value ? klass.namespace_class : nil
948
+ return {} unless ns
949
+
950
+ # Handle special symbols
951
+ return { uri: nil, prefix: nil, class: nil } if %i[blank
952
+ inherit].include?(ns)
953
+
954
+ # XmlNamespace class
955
+ {
956
+ uri: ns.is_a?(Class) && ns < Lutaml::Xml::Namespace ? ns.uri : nil,
957
+ prefix: ns.is_a?(Class) && ns < Lutaml::Xml::Namespace ? ns.prefix_default : nil,
958
+ class: ns,
959
+ }
960
+ end
961
+ end
962
+
963
+ def self.get_target_xsd_type(attr, register)
964
+ return nil unless attr.options[:ref_model_class]
965
+ return nil unless attr.options[:ref_key_attribute]
966
+
967
+ begin
968
+ model_class = Object.const_get(attr.options[:ref_model_class])
969
+ target_attr = model_class.attributes[attr.options[:ref_key_attribute]]
970
+ return nil unless target_attr
971
+
972
+ target_type = target_attr.type(register)
973
+ get_attribute_xsd_type(target_attr, target_type, register)
974
+ rescue NameError
975
+ nil
976
+ end
977
+ end
978
+
979
+ def self.get_xsd_type(type)
980
+ {
981
+ Lutaml::Model::Type::String => "xs:string",
982
+ Lutaml::Model::Type::Integer => "xs:integer",
983
+ Lutaml::Model::Type::Boolean => "xs:boolean",
984
+ Lutaml::Model::Type::Float => "xs:float",
985
+ Lutaml::Model::Type::Decimal => "xs:decimal",
986
+ Lutaml::Model::Type::Date => "xs:date",
987
+ Lutaml::Model::Type::Time => "xs:time",
988
+ Lutaml::Model::Type::DateTime => "xs:dateTime",
989
+ Lutaml::Model::Type::TimeWithoutDate => "xs:time",
990
+ Lutaml::Model::Type::Duration => "xs:duration",
991
+ Lutaml::Model::Type::Uri => "xs:anyURI",
992
+ Lutaml::Model::Type::QName => "xs:QName",
993
+ Lutaml::Model::Type::Base64Binary => "xs:base64Binary",
994
+ Lutaml::Model::Type::HexBinary => "xs:hexBinary",
995
+ Lutaml::Model::Type::Hash => "xs:anyType",
996
+ Lutaml::Model::Type::Symbol => "xs:string",
997
+ }[type] || "xs:string"
998
+ end
999
+ end
1000
+ end
1001
+ end
1002
+ end