lutaml 0.10.17 → 0.10.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 330cf6a6d4021d51bfb8ee166e4f6dce5697ed5fff82cdc6043a6d304d7e853d
-  data.tar.gz: 4bd730f3e5a2ae0427d2157bb862788ddd516280d86b9f791ec3e46473710dac
+  metadata.gz: c13d434118617c3c74306f71dfffaeaa2803b07b0251267798da192d7f6b599f
+  data.tar.gz: c76e117160fadf1b041cc3e6a51fb1ee055416e9014fe7a0fedbfac85344f4e4
 SHA512:
-  metadata.gz: b1cf1135be7d630644fbf782c1070231a54c0c3341b8c1be7c688a4d3c29d2aa34c26ef900f056c8d50f9c10b674e0470d46646de49b5386de51896e45a79ee3
-  data.tar.gz: 5b716ba1f4bd818a81f7fd54567add05c1ed0682fb407379db5d086fc8c636586e5a162480b821a23be4977d31ebe986be61531851faad122ddf0c74785bd59c
+  metadata.gz: f5ff34832797c015997e5b3c2d0c61cd0c3b5c0cd2ca944af09f98b4bab2e3a383386551b9572cea28eeb95fa71743a6453abd95b3d8e8ea80cda05961f30972
+  data.tar.gz: 0e72e6c2c5ef782512e80036e714029a6ae7a620924b7346db474e2ff20e5f2b8e7da8285feead75afe90fc0a9d06cec9b4dcd754eeeb40f4bbb57315a0d5a2f

data/.gitignore

@@ -21,4 +21,9 @@ old-docs
 
 # Transient planning files
 TODO.*/
+TODO.*.md
 .rubocop_todo.yml.tmp
+
+# Frontend build artifacts
+frontend/node_modules/
+TODO.migrate/

data/.rubocop_todo.yml

@@ -1,21 +1,72 @@
 # This configuration was generated by
-# `rubocop --auto-gen-config --no-offense-counts`
-# on 2026-05-13 08:26:11 UTC using RuboCop version 1.86.1.
+# `rubocop --auto-gen-config`
+# 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: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: with_first_argument, with_fixed_indentation
+Layout/ArgumentAlignment:
+  Exclude:
+    - 'lib/lutaml/uml_repository/static_site/data_transformer.rb'
+    - 'lib/lutaml/uml_repository/static_site/generator.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: IndentationWidth.
+Layout/AssignmentIndentation:
+  Exclude:
+    - 'lib/lutaml/uml_repository/static_site/output/vue_inlined_strategy.rb'
+
+# Offense count: 21
+# This cop supports safe autocorrection (--autocorrect).
+# 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: 22
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowInHeredoc.
+Layout/TrailingWhitespace:
+  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:
   Exclude:
     - 'spec/lutaml/qea/lookup_tables_spec.rb'
 
+# Offense count: 15
 # Configuration parameters: AllowedMethods.
 # AllowedMethods: enums
 Lint/ConstantDefinitionInBlock:
@@ -26,12 +77,14 @@ Lint/ConstantDefinitionInBlock:
     - 'spec/lutaml/model_transformations_spec.rb'
     - 'spec/lutaml/uml_repository/presenters/presenter_factory_spec.rb'
 
+# Offense count: 2
 # Configuration parameters: IgnoreLiteralBranches, IgnoreConstantBranches, IgnoreDuplicateElseBranch.
 Lint/DuplicateBranch:
   Exclude:
     - 'lib/lutaml/uml/model_helpers.rb'
     - 'lib/lutaml/uml_repository/queries/package_query.rb'
 
+# Offense count: 4
 # Configuration parameters: AllowComments, AllowEmptyLambdas.
 Lint/EmptyBlock:
   Exclude:
@@ -40,22 +93,25 @@ Lint/EmptyBlock:
     - 'spec/lutaml/uml_repository/package_exporter_spec.rb'
     - 'spec/lutaml/uml_repository/repository_spec.rb'
 
+# Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowComments.
 Lint/EmptyConditionalBody:
   Exclude:
-    - 'spec/integration/qea_xmi_equivalency_spec.rb'
     - 'spec/lutaml/qea/verification/equivalence_integration_spec.rb'
 
+# Offense count: 4
 Lint/IneffectiveAccessModifier:
   Exclude:
     - 'lib/lutaml/uml_repository/repository_enhanced.rb'
 
+# Offense count: 1
 # Configuration parameters: AllowedParentClasses.
 Lint/MissingSuper:
   Exclude:
     - 'lib/lutaml/uml_repository/lazy_repository.rb'
 
+# Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
 # NotImplementedExceptions: NotImplementedError
@@ -63,14 +119,14 @@ Lint/UnusedMethodArgument:
   Exclude:
     - 'lib/lutaml/cli/uml/export_command.rb'
 
+# 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: 13
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
   Exclude:
@@ -79,38 +135,52 @@ 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: 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/queries/search_query.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: 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: 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/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.
 # AllowedNames: as, at, by, cc, db, id, if, in, io, ip, of, on, os, pp, to
 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
 # Configuration parameters: Mode, AllowedMethods, AllowedPatterns, AllowBangMethods, WaywardPredicates.
 # AllowedMethods: call
 # WaywardPredicates: infinite?, nonzero?
@@ -119,25 +189,25 @@ Naming/PredicateMethod:
     - 'lib/lutaml/qea/factory/document_builder.rb'
     - 'spec/lutaml/xmi/liquid_drops/nil_safety_spec.rb'
 
+# Offense count: 2
 # Configuration parameters: MinSize.
 Performance/CollectionLiteralInLoop:
   Exclude:
     - 'spec/lutaml/qea/infrastructure/table_reader_spec.rb'
     - 'spec/lutaml/uml_repository/index_builder_spec.rb'
 
+# Offense count: 2
 Performance/MapMethodChain:
   Exclude:
     - 'lib/lutaml/cli/output_formatter.rb'
     - 'lib/lutaml/qea/models/ea_diagram_link.rb'
 
-RSpec/AnyInstance:
-  Exclude:
-    - 'spec/lutaml/uml_repository/static_site/generator_spec.rb'
-
+# Offense count: 1
 RSpec/BeforeAfterAll:
   Exclude:
     - 'spec/lutaml/qea/verification/comprehensive_equivalence_spec.rb'
 
+# Offense count: 23
 # Configuration parameters: Prefixes, AllowedPatterns.
 # Prefixes: when, with, without
 RSpec/ContextWording:
@@ -153,37 +223,43 @@ RSpec/ContextWording:
     - 'spec/lutaml/cli/uml/tree_command_spec.rb'
     - 'spec/lutaml/cli/uml/verify_command_spec.rb'
     - 'spec/lutaml/qea/integration/full_parsing_spec.rb'
-    - 'spec/lutaml/xml/parsers/xml_spec.rb'
 
+# Offense count: 23
 # Configuration parameters: IgnoredMetadata.
 RSpec/DescribeClass:
   Enabled: false
 
+# Offense count: 684
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
   Max: 30
 
+# Offense count: 7
 # This cop supports safe autocorrection (--autocorrect).
 RSpec/ExpectActual:
   Exclude:
     - 'spec/lutaml/qea/diagram_support_spec.rb'
     - 'spec/lutaml/qea/services/configuration_spec.rb'
 
+# Offense count: 1
 RSpec/ExpectInLet:
   Exclude:
     - 'spec/lutaml/ea/diagram/svg_accuracy_spec.rb'
 
+# Offense count: 90
 RSpec/ExpectOutput:
   Exclude:
     - 'spec/lutaml/cli/interactive_shell_spec.rb'
     - 'spec/lutaml/cli/package_commands_spec.rb'
 
+# Offense count: 5
 # Configuration parameters: Max, AllowedIdentifiers, AllowedPatterns.
 RSpec/IndexedLet:
   Exclude:
     - 'spec/lutaml/qea/repositories/base_repository_spec.rb'
     - 'spec/lutaml/qea/repositories/object_repository_spec.rb'
 
+# Offense count: 15
 RSpec/LeakyConstantDeclaration:
   Exclude:
     - 'spec/lutaml/model_transformations/format_registry_spec.rb'
@@ -192,10 +268,12 @@ RSpec/LeakyConstantDeclaration:
     - 'spec/lutaml/model_transformations_spec.rb'
     - 'spec/lutaml/uml_repository/presenters/presenter_factory_spec.rb'
 
+# Offense count: 1
 RSpec/LeakyLocalVariable:
   Exclude:
     - 'spec/lutaml/ea/diagram/svg_accuracy_spec.rb'
 
+# Offense count: 11
 # Configuration parameters: EnforcedStyle.
 # SupportedStyles: have_received, receive
 RSpec/MessageSpies:
@@ -205,24 +283,34 @@ RSpec/MessageSpies:
     - 'spec/lutaml/uml_repository/presenters/diagram_presenter_spec.rb'
     - 'spec/lutaml/uml_repository/repository_spec.rb'
 
+# 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: 145
 # Configuration parameters: AllowSubject.
 RSpec/MultipleMemoizedHelpers:
   Max: 11
 
+# Offense count: 33
 # Configuration parameters: AllowedGroups.
 RSpec/NestedGroups:
   Max: 4
 
+# 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:
   Exclude:
     - 'spec/lutaml/cli/package_commands_spec.rb'
@@ -230,10 +318,12 @@ RSpec/RepeatedExample:
     - 'spec/lutaml/qea/validation/validation_engine_spec.rb'
     - 'spec/lutaml/uml_repository/static_site/data_transformer_spec.rb'
 
+# Offense count: 2
 RSpec/RepeatedExampleGroupDescription:
   Exclude:
     - 'spec/lutaml/uml/parsers/dsl_spec.rb'
 
+# Offense count: 4
 # Configuration parameters: CustomTransform, IgnoreMethods, IgnoreMetadata, InflectorPath, EnforcedInflector.
 # SupportedInflectors: default, active_support
 RSpec/SpecFilePathFormat:
@@ -243,22 +333,64 @@ RSpec/SpecFilePathFormat:
     - 'spec/lutaml/parsers/serialize_xmi_to_liquid_spec.rb'
     - 'spec/lutaml/uml_repository/web_ui/app_spec.rb'
 
+# Offense count: 1
 Security/MarshalLoad:
   Exclude:
     - 'lib/lutaml/uml_repository/package_loader.rb'
 
+# 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
+# ProceduralMethods: benchmark, bm, bmbm, create, each_with_object, measure, new, realtime, tap, with_object
+# FunctionalMethods: let, let!, subject, watch
+# AllowedMethods: lambda, proc, it
+Style/BlockDelimiters:
+  Exclude:
+    - '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).
 Style/ComparableClamp:
   Exclude:
     - 'lib/lutaml/cli/enhanced_formatter.rb'
 
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Style/NegatedIfElseCondition:
+  Exclude:
+    - 'lib/lutaml/cli/uml/spa_command.rb'
+
+# Offense count: 2
+# Configuration parameters: AllowedClasses.
+Style/OneClassPerFile:
+  Exclude:
+    - 'lib/lutaml/cli.rb'
+    - 'lib/lutaml/qea.rb'
+
+# Offense count: 1
 # This cop supports unsafe autocorrection (--autocorrect-all).
 Style/PartitionInsteadOfDoubleSelect:
   Exclude:
     - 'lib/lutaml/qea/factory/generalization_builder.rb'
 
+# Offense count: 3
 # Configuration parameters: Max.
 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)