lutaml 0.10.18 → 0.10.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c53820c1a0daa57dc4a07ee45bdd249600b22a194d47f0e011fcc14147d15fd
-  data.tar.gz: d03fce90025ce62a4715d187b8e723dd63cb8a768a7e8e016bf4d9160a0ba2dd
+  metadata.gz: c13d434118617c3c74306f71dfffaeaa2803b07b0251267798da192d7f6b599f
+  data.tar.gz: c76e117160fadf1b041cc3e6a51fb1ee055416e9014fe7a0fedbfac85344f4e4
 SHA512:
-  metadata.gz: cebc1ecb62b6a0daa11b21206995fac13a9a45d4ef9707ed248e97ff20757ee6c1a59216b96b00e2fb568bb48966a4660f03a171bc97183b343003796ea1f895
-  data.tar.gz: 0b3280443cd693c733f82a4a43e6b68ba4276bfabf9400d9dddd098e918315ec9bdcdec4138ffd57e0f72d2509b2f388d4de4262e0a6cf24b541f6a2bf89520c
+  metadata.gz: f5ff34832797c015997e5b3c2d0c61cd0c3b5c0cd2ca944af09f98b4bab2e3a383386551b9572cea28eeb95fa71743a6453abd95b3d8e8ea80cda05961f30972
+  data.tar.gz: 0e72e6c2c5ef782512e80036e714029a6ae7a620924b7346db474e2ff20e5f2b8e7da8285feead75afe90fc0a9d06cec9b4dcd754eeeb40f4bbb57315a0d5a2f

data/.gitignore

@@ -23,3 +23,7 @@ old-docs
 TODO.*/
 TODO.*.md
 .rubocop_todo.yml.tmp
+
+# Frontend build artifacts
+frontend/node_modules/
+TODO.migrate/

data/.rubocop_todo.yml

@@ -1,143 +1,65 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-05-14 13:10:59 UTC using RuboCop version 1.86.1.
+# on 2026-05-22 10:40:49 UTC using RuboCop version 1.86.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 67
+# Offense count: 2
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: EnforcedStyle, IndentationWidth.
 # SupportedStyles: with_first_argument, with_fixed_indentation
 Layout/ArgumentAlignment:
-  Enabled: false
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, IndentationWidth.
-# SupportedStyles: with_first_element, with_fixed_indentation
-Layout/ArrayAlignment:
   Exclude:
-    - 'lib/lutaml/uml_repository/repository_enhanced.rb'
+    - 'lib/lutaml/uml_repository/static_site/data_transformer.rb'
+    - 'lib/lutaml/uml_repository/static_site/generator.rb'
 
-# Offense count: 12
+# Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: IndentationWidth.
 Layout/AssignmentIndentation:
   Exclude:
-    - 'lib/lutaml/cli/uml/build_command.rb'
-    - 'lib/lutaml/cli/uml/diagram_command.rb'
-    - 'lib/lutaml/uml_repository/index_builders/class_index.rb'
-    - 'lib/lutaml/uml_repository/index_builders/package_index.rb'
-    - 'lib/lutaml/uml_repository/queries/search_query.rb'
-    - 'lib/lutaml/uml_repository/repository_enhanced.rb'
-
-# Offense count: 13
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyleAlignWith.
-# SupportedStylesAlignWith: either, start_of_block, start_of_line
-Layout/BlockAlignment:
-  Exclude:
-    - 'lib/lutaml/cli/uml/build_command.rb'
-    - 'lib/lutaml/cli/uml/diagram_command.rb'
-    - 'lib/lutaml/uml_repository/queries/search_query.rb'
-    - 'spec/lutaml/cli/search_commands_spec.rb'
-    - 'spec/lutaml/cli/uml/search_command_spec.rb'
-    - 'spec/lutaml/qea/integration/full_parsing_spec.rb'
+    - 'lib/lutaml/uml_repository/static_site/output/vue_inlined_strategy.rb'
 
-# Offense count: 12
-# This cop supports safe autocorrection (--autocorrect).
-Layout/BlockEndNewline:
-  Exclude:
-    - 'lib/lutaml/cli/uml/build_command.rb'
-    - 'lib/lutaml/cli/uml/diagram_command.rb'
-    - 'lib/lutaml/uml_repository/queries/search_query.rb'
-    - 'spec/lutaml/cli/search_commands_spec.rb'
-    - 'spec/lutaml/cli/uml/search_command_spec.rb'
-    - 'spec/lutaml/qea/integration/full_parsing_spec.rb'
-
-# Offense count: 11
+# Offense count: 21
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowForAlignment.
-Layout/CommentIndentation:
-  Exclude:
-    - 'lib/lutaml/uml_repository/index_builders/association_index.rb'
-    - 'lib/lutaml/uml_repository/index_builders/class_index.rb'
-    - 'lib/lutaml/uml_repository/index_builders/package_index.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-Layout/ElseAlignment:
-  Exclude:
-    - 'lib/lutaml/uml_repository/validators/repository_validator.rb'
-
-# Offense count: 137
-# This cop supports safe autocorrection (--autocorrect).
-Layout/EmptyLines:
-  Enabled: false
-
-# Offense count: 2
-# This cop supports safe autocorrection (--autocorrect).
-Layout/EmptyLinesAfterModuleInclusion:
-  Exclude:
-    - 'lib/lutaml/converter/xmi_to_uml.rb'
-    - 'lib/lutaml/xmi/parsers/xmi_base.rb'
-
-# Offense count: 3
-# This cop supports safe autocorrection (--autocorrect).
-Layout/EmptyLinesAroundMethodBody:
-  Exclude:
-    - 'lib/lutaml/cli/uml/build_command.rb'
-    - 'lib/lutaml/cli/uml/spa_command.rb'
-    - 'lib/lutaml/cli/uml/validate_command.rb'
-
-# Offense count: 4
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyleAlignWith.
-# SupportedStylesAlignWith: keyword, variable, start_of_line
-Layout/EndAlignment:
-  Exclude:
-    - 'lib/lutaml/uml_repository/index_builders/association_index.rb'
-    - 'lib/lutaml/uml_repository/index_builders/class_index.rb'
-    - 'lib/lutaml/uml_repository/index_builders/package_index.rb'
-    - 'lib/lutaml/uml_repository/validators/repository_validator.rb'
-
-# Offense count: 51
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: Width, EnforcedStyleAlignWith, AllowedPatterns.
-# SupportedStylesAlignWith: start_of_line, relative_to_receiver
-Layout/IndentationWidth:
-  Exclude:
-    - 'lib/lutaml/cli/uml/build_command.rb'
-    - 'lib/lutaml/cli/uml/diagram_command.rb'
-    - 'lib/lutaml/uml_repository/index_builders/association_index.rb'
-    - 'lib/lutaml/uml_repository/index_builders/class_index.rb'
-    - 'lib/lutaml/uml_repository/index_builders/package_index.rb'
-    - 'lib/lutaml/uml_repository/queries/search_query.rb'
-    - 'lib/lutaml/uml_repository/validators/repository_validator.rb'
-    - 'spec/lutaml/cli/search_commands_spec.rb'
-    - 'spec/lutaml/cli/uml/search_command_spec.rb'
-    - 'spec/lutaml/qea/integration/full_parsing_spec.rb'
-
-# Offense count: 271
+# Configuration parameters: AllowMultipleStyles, EnforcedHashRocketStyle, EnforcedColonStyle, EnforcedLastArgumentHashStyle.
+# SupportedHashRocketStyles: key, separator, table
+# SupportedColonStyles: key, separator, table
+# SupportedLastArgumentHashStyles: always_inspect, always_ignore, ignore_implicit, ignore_explicit
+Layout/HashAlignment:
+  Exclude:
+    - 'lib/lutaml/uml_repository/static_site/models/spa_attribute.rb'
+    - 'lib/lutaml/uml_repository/static_site/models/spa_class.rb'
+    - 'lib/lutaml/uml_repository/static_site/models/spa_operation.rb'
+    - 'lib/lutaml/uml_repository/static_site/models/spa_package.rb'
+    - 'lib/lutaml/uml_repository/static_site/models/spa_package_tree_node.rb'
+    - 'lib/lutaml/uml_repository/static_site/models/spa_tree_class_ref.rb'
+    - 'lib/lutaml/uml_repository/static_site/serializers/metadata_builder.rb'
+
+# Offense count: 216
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
   Enabled: false
 
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-Layout/MultilineBlockLayout:
-  Exclude:
-    - 'spec/lutaml/qea/integration/full_parsing_spec.rb'
-
-# Offense count: 81
+# Offense count: 22
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowInHeredoc.
 Layout/TrailingWhitespace:
-  Enabled: false
+  Exclude:
+    - 'lib/lutaml/uml_repository/static_site/data_transformer.rb'
+    - 'lib/lutaml/uml_repository/static_site/generator.rb'
+    - 'lib/lutaml/uml_repository/static_site/models/spa_attribute.rb'
+    - 'lib/lutaml/uml_repository/static_site/models/spa_class.rb'
+    - 'lib/lutaml/uml_repository/static_site/models/spa_operation.rb'
+    - 'lib/lutaml/uml_repository/static_site/models/spa_package.rb'
+    - 'lib/lutaml/uml_repository/static_site/models/spa_package_tree_node.rb'
+    - 'lib/lutaml/uml_repository/static_site/models/spa_tree_class_ref.rb'
+    - 'lib/lutaml/uml_repository/static_site/output/vue_inlined_strategy.rb'
+    - 'lib/lutaml/uml_repository/static_site/serializers/metadata_builder.rb'
 
 # Offense count: 1
 Lint/BinaryOperatorWithIdenticalOperands:
@@ -197,16 +119,14 @@ Lint/UnusedMethodArgument:
   Exclude:
     - 'lib/lutaml/cli/uml/export_command.rb'
 
-# Offense count: 7
+# Offense count: 4
 Lint/UselessConstantScoping:
   Exclude:
     - 'lib/lutaml/cli/interactive_shell.rb'
     - 'lib/lutaml/cli/uml/diagram_command.rb'
     - 'lib/lutaml/qea/factory/ea_to_uml_factory.rb'
-    - 'lib/lutaml/uml_repository/static_site/generator.rb'
-    - 'lib/lutaml/uml_repository/static_site/serializers/inheritance_resolver.rb'
 
-# Offense count: 10
+# Offense count: 13
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
   Exclude:
@@ -215,39 +135,41 @@ Metrics/AbcSize:
     - 'lib/lutaml/qea/factory/generalization_builder.rb'
     - 'lib/lutaml/uml_repository/exporters/markdown/class_page_builder.rb'
     - 'lib/lutaml/uml_repository/queries/search_query.rb'
+    - 'lib/lutaml/uml_repository/static_site/output/vue_inlined_strategy.rb'
     - 'lib/lutaml/uml_repository/static_site/serializers/class_serializer.rb'
+    - 'lib/lutaml/uml_repository/static_site/serializers/metadata_builder.rb'
 
-# Offense count: 1
-# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
-# AllowedMethods: refine
-Metrics/BlockLength:
-  Max: 27
-
-# Offense count: 3
+# Offense count: 8
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Exclude:
     - 'lib/lutaml/qea/factory/generalization_builder.rb'
+    - 'lib/lutaml/uml/model_helpers.rb'
     - 'lib/lutaml/uml_repository/index_builders/association_index.rb'
-    - 'lib/lutaml/uml_repository/static_site/serializers/class_serializer.rb'
+    - 'lib/lutaml/uml_repository/static_site/data_transformer.rb'
+    - 'lib/lutaml/uml_repository/static_site/generator.rb'
+    - 'lib/lutaml/uml_repository/static_site/output/vue_inlined_strategy.rb'
+    - 'lib/lutaml/uml_repository/static_site/serializers/base.rb'
+    - 'lib/lutaml/uml_repository/static_site/serializers/metadata_builder.rb'
 
-# Offense count: 55
+# Offense count: 63
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
-  Max: 17
+  Max: 23
 
 # Offense count: 5
 # Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
 Metrics/ParameterLists:
   Max: 7
 
-# Offense count: 3
+# Offense count: 4
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/PerceivedComplexity:
   Exclude:
     - 'lib/lutaml/qea/factory/ea_to_uml_factory.rb'
-    - 'lib/lutaml/uml_repository/static_site/serializers/class_serializer.rb'
-    - 'lib/lutaml/uml_repository/validators/repository_validator.rb'
+    - 'lib/lutaml/uml_repository/static_site/generator.rb'
+    - 'lib/lutaml/uml_repository/static_site/output/vue_inlined_strategy.rb'
+    - 'lib/lutaml/uml_repository/static_site/serializers/base.rb'
 
 # Offense count: 3
 # Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
@@ -255,7 +177,7 @@ Metrics/PerceivedComplexity:
 Naming/MethodParameterName:
   Exclude:
     - 'lib/lutaml/cli/tree_view_formatter.rb'
-    - 'lib/lutaml/uml_repository/static_site/generator.rb'
+    - 'lib/lutaml/uml_repository/static_site/output/vue_inlined_strategy.rb'
     - 'spec/lutaml/parsers/serialize_xmi_to_liquid_spec.rb'
 
 # Offense count: 3
@@ -280,11 +202,6 @@ Performance/MapMethodChain:
     - 'lib/lutaml/cli/output_formatter.rb'
     - 'lib/lutaml/qea/models/ea_diagram_link.rb'
 
-# Offense count: 5
-RSpec/AnyInstance:
-  Exclude:
-    - 'spec/lutaml/uml_repository/static_site/generator_spec.rb'
-
 # Offense count: 1
 RSpec/BeforeAfterAll:
   Exclude:
@@ -307,12 +224,12 @@ RSpec/ContextWording:
     - 'spec/lutaml/cli/uml/verify_command_spec.rb'
     - 'spec/lutaml/qea/integration/full_parsing_spec.rb'
 
-# Offense count: 22
+# Offense count: 23
 # Configuration parameters: IgnoredMetadata.
 RSpec/DescribeClass:
   Enabled: false
 
-# Offense count: 646
+# Offense count: 684
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
   Max: 30
@@ -366,11 +283,17 @@ RSpec/MessageSpies:
     - 'spec/lutaml/uml_repository/presenters/diagram_presenter_spec.rb'
     - 'spec/lutaml/uml_repository/repository_spec.rb'
 
-# Offense count: 40
+# Offense count: 2
+RSpec/MultipleDescribes:
+  Exclude:
+    - 'spec/lutaml/uml_repository/static_site/models_spec.rb'
+    - 'spec/lutaml/uml_repository/static_site/output_strategy_spec.rb'
+
+# Offense count: 84
 RSpec/MultipleExpectations:
-  Max: 7
+  Max: 12
 
-# Offense count: 148
+# Offense count: 145
 # Configuration parameters: AllowSubject.
 RSpec/MultipleMemoizedHelpers:
   Max: 11
@@ -380,13 +303,12 @@ RSpec/MultipleMemoizedHelpers:
 RSpec/NestedGroups:
   Max: 4
 
-# Offense count: 2
+# Offense count: 1
 # Configuration parameters: AllowedPatterns.
 # AllowedPatterns: ^expect_, ^assert_
 RSpec/NoExpectationExample:
   Exclude:
     - 'spec/lutaml/qea/verification/comprehensive_equivalence_spec.rb'
-    - 'spec/lutaml/uml_repository/static_site/generator_spec.rb'
 
 # Offense count: 12
 RSpec/RepeatedExample:
@@ -416,7 +338,7 @@ Security/MarshalLoad:
   Exclude:
     - 'lib/lutaml/uml_repository/package_loader.rb'
 
-# Offense count: 17
+# Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: EnforcedStyle, ProceduralMethods, FunctionalMethods, AllowedMethods, AllowedPatterns, AllowBracesOnProceduralOneLiners, BracesRequiredMethods.
 # SupportedStyles: line_count_based, semantic, braces_for_chaining, always_braces
@@ -425,12 +347,14 @@ Security/MarshalLoad:
 # AllowedMethods: lambda, proc, it
 Style/BlockDelimiters:
   Exclude:
-    - 'lib/lutaml/cli/uml/build_command.rb'
-    - 'lib/lutaml/cli/uml/diagram_command.rb'
-    - 'lib/lutaml/uml_repository/queries/search_query.rb'
-    - 'spec/lutaml/cli/search_commands_spec.rb'
-    - 'spec/lutaml/cli/uml/search_command_spec.rb'
-    - 'spec/lutaml/qea/integration/full_parsing_spec.rb'
+    - 'lib/lutaml/uml_repository/static_site/serializers/metadata_builder.rb'
+
+# Offense count: 1
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: MinBranchesCount.
+Style/CaseLikeIf:
+  Exclude:
+    - 'lib/lutaml/uml/model_helpers.rb'
 
 # Offense count: 2
 # This cop supports safe autocorrection (--autocorrect).
@@ -438,21 +362,11 @@ Style/ComparableClamp:
   Exclude:
     - 'lib/lutaml/cli/enhanced_formatter.rb'
 
-# Offense count: 16
-# This cop supports safe autocorrection (--autocorrect).
-Style/MultilineIfModifier:
-  Exclude:
-    - 'lib/lutaml/cli/uml/build_command.rb'
-    - 'lib/lutaml/cli/uml/diagram_command.rb'
-    - 'lib/lutaml/uml_repository/index_builders/class_index.rb'
-    - 'lib/lutaml/uml_repository/index_builders/package_index.rb'
-    - 'lib/lutaml/uml_repository/repository_enhanced.rb'
-
 # Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
-Style/MultilineTernaryOperator:
+Style/NegatedIfElseCondition:
   Exclude:
-    - 'lib/lutaml/uml_repository/validators/repository_validator.rb'
+    - 'lib/lutaml/cli/uml/spa_command.rb'
 
 # Offense count: 2
 # Configuration parameters: AllowedClasses.
@@ -473,3 +387,10 @@ Style/SafeNavigationChainLength:
   Exclude:
     - 'lib/lutaml/qea/validation/attribute_validator.rb'
     - 'lib/lutaml/qea/validation/operation_validator.rb'
+
+# Offense count: 1
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: Mode.
+Style/StringConcatenation:
+  Exclude:
+    - 'lib/lutaml/cli/uml/spa_command.rb'

data/CLAUDE.md

@@ -22,6 +22,23 @@ Lutaml is a Ruby gem for parsing and transforming UML models from multiple forma
 - DRY: consolidate duplicated patterns (especially `format_definition`, index building, metadata construction).
 - Never commit TODO tracking files to git.
 
+## Spec Require Rules
+
+**ALWAYS use `require_relative` in spec files. NEVER use bare `require`.**
+
+`require` depends on `$LOAD_PATH` which is unreliable:
+- Running a single spec file (`bundle exec rspec spec/foo/bar_spec.rb`) may not have `lib/` on the load path, causing `LoadError`.
+- If the gem is installed globally, `require "lutaml/foo"` loads the installed gem version, not the local working copy — specs silently test the wrong code.
+- `require_relative` resolves relative to the spec file's location. It always loads the exact file you intend, regardless of how the spec is run.
+
+```ruby
+# WRONG — may load wrong file or fail
+require "lutaml/uml_repository/static_site/data_transformer"
+
+# CORRECT — always loads the local file
+require_relative "../../../lib/lutaml/uml_repository/static_site/data_transformer"
+```
+
 ## Architecture
 - `lib/lutaml/uml/` — UML domain models (Class, Association, Package, etc.)
 - `lib/lutaml/uml_repository/` — Repository pattern over UML documents (queries, presenters, exporters, SPA)