ea 0.2.5 → 0.3.1

data/lib/ea/svg/element_box.rb

@@ -0,0 +1,256 @@
+# frozen_string_literal: true
+
+require "ostruct"
+
+module Ea
+  module Svg
+    # Renders one DiagramElement as a 3-compartment UML class box,
+    # matching EA's drawing convention:
+    #
+    #   ┌─────────────────────────┐
+    #   │ «Stereotype»            │  ← header (stereotype + name)
+    #   │ qualified::Name         │
+    #   ├─────────────────────────┤
+    #   │ + attr1: Type [0..1]    │  ← attributes
+    #   │ + attr2: Type [0..*]    │
+    #   ├─────────────────────────┤
+    #   │ + op1(arg: T): T        │  ← operations
+    #   └─────────────────────────┘
+    #
+    # The stored element bounds are honored as the outer rectangle;
+    # internal layout (header / attrs / ops heights) is computed
+    # proportionally based on line count.
+    class ElementBox
+      HEADER_LINE_HEIGHT = 17
+      ATTR_LINE_HEIGHT   = 17
+      OP_LINE_HEIGHT     = 17
+      TOP_PADDING        = 17
+
+      STEREOTYPE_COLORS = {
+        "featuretype" => "#FFFFCC", # yellow
+        "feature"     => "#FFFFCC",
+        "type"        => "#CCFFCC", # green
+        "datatype"    => "#FFCCFF", # pink
+        "basictype"   => "#FFCCFF",
+        "codelist"    => "#FFCCFF",
+        "enumeration" => "#FFCCFF",
+        "union"       => "#F0E68C", # khaki
+        "adeelement"  => "#F5F5DC"  # beige
+      }.freeze
+      DEFAULT_FILL = "#FFFFFF"
+
+      attr_reader :element, :model_index
+
+      def initialize(element, model_index:)
+        @element = element
+        @model_index = model_index
+      end
+
+      def render
+        return "" unless element.bounds
+
+        b = normalize_bounds(element.bounds)
+        classifier = bound_classifier
+        return render_simple_box(b) unless classifier
+
+        render_class_box(b, classifier)
+      end
+
+      private
+
+      def bound_classifier
+        ref = element.model_element_ref
+        return nil unless ref
+
+        candidate = model_index[ref]
+        return nil unless candidate.is_a?(Ea::Model::Classifier)
+
+        candidate
+      end
+
+      def render_simple_box(bounds)
+        style = StyleResolver.new(element.style)
+        <<~SVG.chomp
+          <g class="element" data-element-id="#{escape(element.id)}">
+            <rect x="#{bounds.x}" y="#{bounds.y}" width="#{bounds.width}" height="#{bounds.height}"
+                  fill="#{fill_color(style)}" stroke="#{style.stroke_color}"
+                  stroke-width="#{style.stroke_width}"/>
+            <text x="#{bounds.x + (bounds.width / 2.0)}"
+                  y="#{bounds.y + (bounds.height / 2.0)}"
+                  text-anchor="middle" dominant-baseline="middle"
+                  fill="#{style.font_color}"
+                  font-family="sans-serif" font-size="14">#{escape(element.id)}</text>
+          </g>
+        SVG
+      end
+
+      def render_class_box(bounds, classifier)
+        stereotype = primary_stereotype(classifier)
+        fill = STEREOTYPE_COLORS[stereotype&.downcase] || DEFAULT_FILL
+        style = StyleResolver.new(element.style)
+        stroke = style.stroke_color
+        stroke_width = style.stroke_width
+        font_color = style.font_color
+
+        header_lines = build_header_lines(classifier, stereotype)
+        attr_lines = build_attribute_lines(classifier)
+        op_lines = build_operation_lines(classifier)
+
+        header_bottom = bounds.y + header_height(header_lines.size)
+        attrs_bottom = header_bottom + compartment_height(attr_lines.size)
+        ops_bottom = attrs_bottom + compartment_height(op_lines.size)
+
+        parts = []
+        parts << %(<g class="element" data-element-id="#{escape(element.id)}">)
+        parts << render_outer_rect(bounds, fill, stroke, stroke_width)
+        parts << render_header_divider(bounds, header_bottom, stroke, stroke_width)
+        parts << render_attrs_divider(bounds, attrs_bottom, stroke, stroke_width) if op_lines.any?
+        parts << render_header_text(bounds, header_lines, font_color)
+        parts << render_attribute_text(bounds, header_bottom, attr_lines, font_color)
+        parts << render_operation_text(bounds, attrs_bottom, op_lines, font_color)
+        parts << %(</g>)
+        parts.join("\n            ")
+      end
+
+      def build_header_lines(classifier, stereotype)
+        lines = []
+        lines << "«#{stereotype}»" if stereotype && !stereotype.empty?
+        lines << (classifier.qualified_name&.split("::")&.last || classifier.name || "(unnamed)")
+        lines
+      end
+
+      def build_attribute_lines(classifier)
+        return [] unless classifier.properties
+
+        classifier.properties.map do |prop|
+          vis = visibility_marker(prop.visibility)
+          mult = multiplicity_text(prop)
+          type = prop.type_name ? ": #{prop.type_name}" : ""
+          "#{vis} #{prop.name}#{type}#{mult}"
+        end
+      end
+
+      def build_operation_lines(classifier)
+        return [] unless classifier.operations
+
+        classifier.operations.map do |op|
+          vis = visibility_marker(op.visibility)
+          ret = op.return_type_name ? ": #{op.return_type_name}" : ""
+          params = (op.parameters || []).map { |p| "#{p.name}: #{p.type_name || 'T'}" }.join(", ")
+          "#{vis} #{op.name}(#{params})#{ret}"
+        end
+      end
+
+      def visibility_marker(visibility)
+        case visibility&.downcase
+        when "public" then "+"
+        when "private" then "-"
+        when "protected" then "#"
+        when "package" then "~"
+        else "+"
+        end
+      end
+
+      def multiplicity_text(prop)
+        lower = prop.multiplicity_lower
+        upper = prop.multiplicity_upper
+        return "" if lower.nil? && upper.nil?
+        return "" if lower == 1 && upper == 1
+
+        upper_text = upper == -1 ? "*" : upper
+        lower_text = lower || 0
+        return "[0..*]" if lower_text == 0 && upper == -1
+        return "[#{lower_text}]" if lower_text == upper
+
+        "[#{lower_text}..#{upper_text}]"
+      end
+
+      def primary_stereotype(classifier)
+        refs = classifier.stereotype_refs
+        return nil if refs.nil? || refs.empty?
+
+        refs.first.to_s.split("::").last
+      end
+
+      def fill_color(style)
+        stereotype = primary_stereotype_from_style
+        STEREOTYPE_COLORS[stereotype&.downcase] || style.fill_color
+      end
+
+      def primary_stereotype_from_style
+        nil
+      end
+
+      def header_height(line_count)
+        TOP_PADDING + (line_count * HEADER_LINE_HEIGHT)
+      end
+
+      def compartment_height(line_count)
+        return 0 if line_count.zero?
+
+        10 + (line_count * (line_count == 0 ? 0 : (line_count < 3 ? 17 : 17)))
+      end
+
+      def render_outer_rect(bounds, fill, stroke, stroke_width)
+        %(  <rect x="#{bounds.x}" y="#{bounds.y}" width="#{bounds.width}" height="#{bounds.height}" fill="#{fill}" stroke="#{stroke}" stroke-width="#{stroke_width}"/>)
+      end
+
+      def render_header_divider(bounds, y, stroke, stroke_width)
+        %(  <path d="M #{bounds.x} #{y} L #{bounds.x + bounds.width} #{y}" stroke="#{stroke}" stroke-width="#{stroke_width}" fill="none"/>)
+      end
+
+      def render_attrs_divider(bounds, y, stroke, stroke_width)
+        %(  <path d="M #{bounds.x} #{y} L #{bounds.x + bounds.width} #{y}" stroke="#{stroke}" stroke-width="#{stroke_width}" fill="none"/>)
+      end
+
+      def render_header_text(bounds, lines, font_color)
+        center_x = bounds.x + (bounds.width / 2.0)
+        lines.each_with_index.map do |line, idx|
+          y = bounds.y + TOP_PADDING + (idx * HEADER_LINE_HEIGHT) - 4
+          weight = (idx == lines.size - 1) ? "bold" : "normal"
+          %(  <text x="#{center_x}" y="#{y}" text-anchor="middle" fill="#{font_color}" font-family="sans-serif" font-size="13" font-weight="#{weight}">#{escape(line)}</text>)
+        end.join("\n            ")
+      end
+
+      def render_attribute_text(bounds, header_bottom, lines, font_color)
+        return "" if lines.empty?
+
+        left = bounds.x + 5
+        lines.each_with_index.map do |line, idx|
+          y = header_bottom + 14 + (idx * ATTR_LINE_HEIGHT)
+          %(  <text x="#{left}" y="#{y}" text-anchor="start" fill="#{font_color}" font-family="sans-serif" font-size="12">#{escape(line)}</text>)
+        end.join("\n            ")
+      end
+
+      def render_operation_text(bounds, attrs_bottom, lines, font_color)
+        return "" if lines.empty?
+
+        left = bounds.x + 5
+        lines.each_with_index.map do |line, idx|
+          y = attrs_bottom + 14 + (idx * OP_LINE_HEIGHT)
+          %(  <text x="#{left}" y="#{y}" text-anchor="start" fill="#{font_color}" font-family="sans-serif" font-size="12">#{escape(line)}</text>)
+        end.join("\n            ")
+      end
+
+      def normalize_bounds(bounds)
+        x = bounds.x
+        y = bounds.y
+        w = bounds.width
+        h = bounds.height
+        x, w = x + w, -w if w.negative?
+        y, h = y + h, -h if h.negative?
+        OpenStruct.new(x: x, y: y, width: w, height: h)
+      end
+
+      def escape(text)
+        return "" if text.nil?
+
+        text.to_s
+            .gsub("&", "&amp;")
+            .gsub("<", "&lt;")
+            .gsub(">", "&gt;")
+            .gsub("\"", "&quot;")
+      end
+    end
+  end
+end

data/lib/ea/svg/renderer.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require "ostruct"
+
+module Ea
+  module Svg
+    # Renders an Ea::Model::Diagram into a standalone SVG string.
+    # Coordinates come straight from the umldi (UML Diagram
+    # Interchange) content captured by the source adapter:
+    # DiagramElement bounds and DiagramConnector waypoints.
+    #
+    # The renderer walks the diagram once, computes the union
+    # bounding box, and emits SVG in the same coordinate space
+    # (no y-flip; SVG's +y is down, same as EA's pixel space).
+    class Renderer
+      DEFAULT_PADDING = 20
+
+      attr_reader :diagram, :model_index, :options
+
+      def initialize(diagram, model_index: {}, padding: DEFAULT_PADDING)
+        @diagram = diagram
+        @model_index = model_index
+        @options = { padding: padding }
+      end
+
+      def render
+        bounds = BoundsCalculator.new(diagram).compute
+        padded = pad(bounds)
+
+        <<~SVG
+          <?xml version="1.0" encoding="UTF-8"?>
+          <svg xmlns="http://www.w3.org/2000/svg"
+               viewBox="#{padded.x} #{padded.y} #{padded.width} #{padded.height}"
+               width="#{padded.width}" height="#{padded.height}"
+               font-family="sans-serif">
+            <rect x="#{padded.x}" y="#{padded.y}"
+                  width="#{padded.width}" height="#{padded.height}"
+                  fill="white"/>
+            #{render_elements}
+            #{render_connectors}
+          </svg>
+        SVG
+      end
+
+      private
+
+      def render_elements
+        diagram.elements.map do |elem|
+          ElementBox.new(elem, model_index: model_index).render
+        end.join("\n            ")
+      end
+
+      def render_connectors
+        diagram.connectors.map do |conn|
+          ConnectorPath.new(conn,
+                             relationship: relationship_for(conn)).render
+        end.join("\n            ")
+      end
+
+      def relationship_for(connector)
+        return nil unless connector.relationship_ref
+
+        model_index[connector.relationship_ref]
+      end
+
+      def pad(bounds)
+        p = options[:padding]
+        OpenStruct.new(
+          x: bounds.x - p,
+          y: bounds.y - p,
+          width: bounds.width + (2 * p),
+          height: bounds.height + (2 * p)
+        )
+      end
+    end
+  end
+end

data/lib/ea/svg/style_resolver.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Ea
+  module Svg
+    # Translates the parsed style hash (from
+    # Ea::Sources::Qea::DiagramStyleParser, or the equivalent for
+    # XMI) into SVG-friendly attributes. EA packs colors as
+    # integers (e.g. 16777215 = white); we translate to CSS hex.
+    class StyleResolver
+      DEFAULT_FILL = "#ffffff"
+      DEFAULT_STROKE = "#000000"
+      DEFAULT_FONT_COLOR = "#000000"
+
+      attr_reader :style
+
+      def initialize(style_hash)
+        @style = style_hash || {}
+      end
+
+      def fill_color
+        color_from_ea(style[:bcol]) || DEFAULT_FILL
+      end
+
+      def stroke_color
+        color_from_ea(style[:lcol]) || DEFAULT_STROKE
+      end
+
+      def font_color
+        color_from_ea(style[:fcol]) || DEFAULT_FONT_COLOR
+      end
+
+      def stroke_width
+        raw = style[:lwd]
+        return 1 if raw.nil? || raw.to_s.empty?
+
+        Integer(raw)
+      rescue ArgumentError
+        1
+      end
+
+      def to_svg_attrs
+        {
+          fill: fill_color,
+          stroke: stroke_color,
+          "stroke-width": stroke_width
+        }
+      end
+
+      # EA stores colors as decimal integers in BGR byte order
+      # (low byte = red, high byte = blue). The high byte may hold
+      # alpha in some variants; we treat anything above 0xFFFFFF
+      # as opaque.
+      def color_from_ea(raw)
+        return nil if raw.nil? || raw.to_s.empty?
+
+        # Hex strings (e.g. from XMI): passthrough.
+        return "##{raw}" if raw.to_s.match?(/\A[0-9a-fA-F]{6}\z/)
+
+        Integer(raw.to_s)
+      rescue ArgumentError
+        nil
+      else
+        # Convert BGR integer → RGB hex.
+        value = Integer(raw)
+        b = (value >> 16) & 0xff
+        g = (value >> 8) & 0xff
+        r = value & 0xff
+        format("#%02X%02X%02X", r, g, b)
+      end
+    end
+  end
+end

data/lib/ea/svg.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Ea
+  # Ea::Svg is a consumer adapter of Ea::Model::Diagram — it
+  # projects the umldi (UML Diagram Interchange) content of a
+  # diagram into standalone SVG. Coordinates are taken straight
+  # from the source: EA's pixel space (rectleft, recttop,
+  # rectright, rectbottom, t_diagramlinks.geometry) or XMI's
+  # uml:Diagram owned_element bounds.
+  #
+  # Distinct from Ea::Diagram::SvgRenderer which operates on the
+  # legacy Lutaml::Uml::Document pipeline. This module consumes
+  # the canonical Ea::Model types only.
+  module Svg
+    autoload :BoundsCalculator, "ea/svg/bounds_calculator"
+    autoload :StyleResolver, "ea/svg/style_resolver"
+    autoload :ElementBox, "ea/svg/element_box"
+    autoload :ConnectorPath, "ea/svg/connector_path"
+    autoload :Renderer, "ea/svg/renderer"
+  end
+end

data/lib/ea/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ea
-  VERSION = "0.2.5"
+  VERSION = "0.3.1"
 end

data/lib/ea.rb

@@ -9,6 +9,10 @@ module Ea
   class Error < StandardError; end
 
   autoload :Qea, "ea/qea"
+  autoload :Model, "ea/model"
+  autoload :Sources, "ea/sources"
+  autoload :Spa, "ea/spa"
+  autoload :Svg, "ea/svg"
   autoload :Diagram, "ea/diagram"
   autoload :Transformations, "ea/transformations"
   autoload :Xmi, "ea/xmi"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ea
 version: !ruby/object:Gem::Version
-  version: 0.2.5
+  version: 0.3.1
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-18 00:00:00.000000000 Z
+date: 2026-07-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lutaml-model
@@ -234,6 +234,18 @@ files:
 - TODO.next/38-xmi-parser-feature-parity.md
 - TODO.next/39-ea-spa-cli-command.md
 - TODO.next/40-drop-lur-only-check-in-diagrams-extract.md
+- TODO.refactor/01-ea-model-domain-layer.md
+- TODO.refactor/02-ea-model-qea-source-adapter.md
+- TODO.refactor/03-ea-model-xmi-source-adapter.md
+- TODO.refactor/04-ea-model-annotations-tagged-values.md
+- TODO.refactor/05-ea-model-diagrams-coordinates.md
+- TODO.refactor/06-spa-projection-layer.md
+- TODO.refactor/07-spa-sharded-output-strategy.md
+- TODO.refactor/08-spa-build-time-search-index.md
+- TODO.refactor/09-spa-frontend-data-contract.md
+- TODO.refactor/10-spa-cli-command-rework.md
+- TODO.refactor/11-spa-perf-benchmark.md
+- TODO.refactor/12-lutaml-uml-static-site-deprecation.md
 - TODO.release/01-release-lutaml-uml-030.md
 - TODO.release/02-fix-lutaml-meta-gem-requires.md
 - TODO.release/03-release-lutaml-0110.md
@@ -281,6 +293,7 @@ files:
 - lib/ea/cli/command/repository_builder.rb
 - lib/ea/cli/command/spa.rb
 - lib/ea/cli/command/stats.rb
+- lib/ea/cli/command/svg.rb
 - lib/ea/cli/command/validate.rb
 - lib/ea/cli/error.rb
 - lib/ea/cli/output.rb
@@ -302,6 +315,36 @@ files:
 - lib/ea/diagram/style_resolver.rb
 - lib/ea/diagram/svg_renderer.rb
 - lib/ea/diagram/util.rb
+- lib/ea/model.rb
+- lib/ea/model/annotation.rb
+- lib/ea/model/association.rb
+- lib/ea/model/base.rb
+- lib/ea/model/bounds.rb
+- lib/ea/model/classifier.rb
+- lib/ea/model/data_type.rb
+- lib/ea/model/dependency.rb
+- lib/ea/model/diagram.rb
+- lib/ea/model/diagram_connector.rb
+- lib/ea/model/diagram_element.rb
+- lib/ea/model/document.rb
+- lib/ea/model/enumeration.rb
+- lib/ea/model/enumeration_literal.rb
+- lib/ea/model/generalization.rb
+- lib/ea/model/interface.rb
+- lib/ea/model/klass.rb
+- lib/ea/model/metadata.rb
+- lib/ea/model/operation.rb
+- lib/ea/model/package.rb
+- lib/ea/model/parameter.rb
+- lib/ea/model/point.rb
+- lib/ea/model/polymorphic_maps.rb
+- lib/ea/model/primitive_type.rb
+- lib/ea/model/property.rb
+- lib/ea/model/realization.rb
+- lib/ea/model/relationship.rb
+- lib/ea/model/stereotype.rb
+- lib/ea/model/tagged_value.rb
+- lib/ea/model/waypoint.rb
 - lib/ea/qea.rb
 - lib/ea/qea/benchmark.rb
 - lib/ea/qea/database.rb
@@ -390,6 +433,58 @@ files:
 - lib/ea/qea/verification/document_verifier.rb
 - lib/ea/qea/verification/element_comparator.rb
 - lib/ea/qea/verification/structure_matcher.rb
+- lib/ea/sources.rb
+- lib/ea/sources/qea.rb
+- lib/ea/sources/qea/adapter.rb
+- lib/ea/sources/qea/annotation_builder.rb
+- lib/ea/sources/qea/classifier_builder.rb
+- lib/ea/sources/qea/connector_relationship_map.rb
+- lib/ea/sources/qea/diagram_builder.rb
+- lib/ea/sources/qea/diagram_style_parser.rb
+- lib/ea/sources/qea/id_normalizer.rb
+- lib/ea/sources/qea/metadata_builder.rb
+- lib/ea/sources/qea/object_classifier_map.rb
+- lib/ea/sources/qea/operation_builder.rb
+- lib/ea/sources/qea/package_builder.rb
+- lib/ea/sources/qea/property_builder.rb
+- lib/ea/sources/qea/relationship_builder.rb
+- lib/ea/sources/qea/stereotype_builder.rb
+- lib/ea/sources/qea/tagged_value_builder.rb
+- lib/ea/sources/xmi.rb
+- lib/ea/sources/xmi/adapter.rb
+- lib/ea/sources/xmi/annotation_builder.rb
+- lib/ea/sources/xmi/classifier_builder.rb
+- lib/ea/sources/xmi/diagram_builder.rb
+- lib/ea/sources/xmi/id_normalizer.rb
+- lib/ea/sources/xmi/metadata_builder.rb
+- lib/ea/sources/xmi/operation_builder.rb
+- lib/ea/sources/xmi/package_builder.rb
+- lib/ea/sources/xmi/property_builder.rb
+- lib/ea/sources/xmi/relationship_builder.rb
+- lib/ea/sources/xmi/relationship_type_map.rb
+- lib/ea/sources/xmi/type_classifier_map.rb
+- lib/ea/spa.rb
+- lib/ea/spa/configuration.rb
+- lib/ea/spa/generator.rb
+- lib/ea/spa/lazy_ref.rb
+- lib/ea/spa/output.rb
+- lib/ea/spa/output/sharded_multi_file_strategy.rb
+- lib/ea/spa/output/single_file_strategy.rb
+- lib/ea/spa/output/strategy.rb
+- lib/ea/spa/package_tree.rb
+- lib/ea/spa/package_tree_node.rb
+- lib/ea/spa/projector.rb
+- lib/ea/spa/search_entry.rb
+- lib/ea/spa/search_index.rb
+- lib/ea/spa/shard.rb
+- lib/ea/spa/skeleton.rb
+- lib/ea/spa/skeleton_entry.rb
+- lib/ea/svg.rb
+- lib/ea/svg/bounds_calculator.rb
+- lib/ea/svg/connector_path.rb
+- lib/ea/svg/element_box.rb
+- lib/ea/svg/renderer.rb
+- lib/ea/svg/style_resolver.rb
 - lib/ea/transformations.rb
 - lib/ea/transformations/configuration.rb
 - lib/ea/transformations/format_registry.rb