ea 0.6.99 → 0.6.101

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4b9e7581bab2de7d7c5766a5f141c99885bb59cbb7ad974c313c26e86bfb96a2
-  data.tar.gz: 8933e36fb2422953eddb1d60069664e39177547beaf2ec17ed17c5b9f3aa4eac
+  metadata.gz: 7c722ef7c5b7c7968f5beb08538b31b8090a3ab1533b0418a9600752c2724ef3
+  data.tar.gz: 818694e4771383a00ae453f76a7b3f98e79b6b5a839d9459d415ec72129e4226
 SHA512:
-  metadata.gz: ab6882700d57207a5fd2c1b27fa0befe5f287bb61f13387e99dc8f4429dbede75320d9fb6124a126094455d38d4dff7a41dbfc258633609c6695c5dcd216b36d
-  data.tar.gz: 82cd636abfe8c20a03dc8f6c5410192c65e674093eaaabc081e8fc84b7ec6544a87f3c87ff255f90fcaa1bc0f7704fdf1b2e46f344cf9288cd51ec4a7e8cfa97
+  metadata.gz: b00b8fddbd7701f724dc20bd6640dfc53b7a99903d7a075581be94c9f3674254a114fa976a2a895d5ba231ca3b0c93f7b8ce241c42ef4d5c9e106f82c7b660a6
+  data.tar.gz: c41701279192e06adba33b39063dac26a9355dedf1a46fd687079013c341c880f8f3d83278876593cf27733c527f41e22032140b901246b0b6e335cf29dcb308

data/lib/ea/sources/qea/diagram_builder/routing.rb

@@ -23,6 +23,56 @@ module Ea
             set_stored_ray_origins(model, source, target, geom)
           end
 
+          # A Mode 2 Generalization whose stored Path is a horizontal jog
+          # between vertically separated boxes that overlap in x is EA's
+          # auto-route: one vertical ray at the overlap midpoint plus SX.
+          # The stored jog is stale; the ray docks on both 1px outlines.
+          def mode2_overlap_ray(model, link_row, diagram_row, geom, context)
+            return model if context || !mode2_overlap_candidate?(model, link_row, geom)
+
+            source, target = stored_ray_boxes(link_row, diagram_row)
+            column = overlap_ray_coordinate(source.x, source.width, target.x, target.width, geom[:sx])
+            return model unless column && vertical_separation?(source, target)
+
+            set_overlap_ray(model, column, source, target)
+          end
+
+          def set_overlap_ray(model, column, source, target)
+            model.waypoints = overlap_ray_ends(column, source, target).map do |x, y|
+              Ea::Model::Waypoint.new(position: Ea::Model::Point.new(x: x, y: y))
+            end
+            model.source_anchor, model.target_anchor = [source, target].map do |box|
+              Ea::Model::Point.new(x: column, y: box.y + box.height / 2)
+            end
+            model
+          end
+
+          def mode2_overlap_candidate?(model, link_row, geom)
+            model.connector_type == "Generalization" && model.has_geometry_offsets &&
+              mode2_overlap_style?(model.style.to_h, geom) && model.waypoints.size == 4 &&
+              horizontal_jog?(intermediate_waypoints(link_row))
+          end
+
+          def mode2_overlap_style?(style, geom)
+            style[:mode] == "2" && style[:lwidth] == "2" && !style[:tree] && geom[:edge] == 1 && geom[:sx]
+          end
+
+          def horizontal_jog?(corners)
+            corners.size == 2 && corners[0][1] == corners[1][1]
+          end
+
+          def vertical_separation?(source, target)
+            source.y + source.height < target.y || target.y + target.height < source.y
+          end
+
+          def overlap_ray_ends(column, source, target)
+            if target.y + target.height < source.y
+              [[column, source.y - 1], [column, target.y + target.height + 1]]
+            else
+              [[column, source.y + source.height + 1], [column, target.y - 1]]
+            end
+          end
+
           def empty_path_ray_gap?(source, target, geom)
             return false unless source.x + source.width < target.x
 
@@ -55,6 +105,149 @@ module Ea
             set_stored_ray_origins(model, source, target, geom)
           end
 
+          # An empty-Path Mode 3 Association with explicit offsets on both
+          # ends is the straight line between the two stored ray origins.
+          # Origins outside their own box are not a stored ray.
+          def association_stored_ray(model, link_row, diagram_row, geom, context)
+            return model if context
+            return model unless association_ray_candidate?(model, link_row)
+
+            source, target = stored_ray_boxes(link_row, diagram_row)
+            origins = association_ray_origins(source, target, geom, model.style.to_h[:lwidth])
+            return model unless origins
+
+            model.waypoints = port_waypoints(model)
+            model.source_anchor, model.target_anchor = origins
+            model.style = model.style.to_h.merge(stored_association_ray: true, association_ray_outline: true)
+            model
+          end
+
+          def port_waypoints(model)
+            [model.source_port, model.target_port].map do |point|
+              Ea::Model::Waypoint.new(position: point)
+            end
+          end
+
+          # Width-2 boxes also own their 1px outer stroke, so a stored
+          # origin on that outline is still inside its box.
+          def association_ray_origins(source, target, geom, width)
+            outline = width == "2" ? 1 : 0
+            origins = [stored_ray_origin(source, geom[:sx], geom[:sy]),
+                       stored_ray_origin(target, geom[:ex], geom[:ey])]
+            boxes = [source, target].map { |box| grown_bounds(box, outline) }
+            inside = origins.zip(boxes).all? { |o, b| inside_box?(o, b) }
+            return unless inside && origins.first != origins.last
+
+            origins if width == "2" || sub_pixel_safe_origins?(origins, [source, target] + boxes)
+          end
+
+          def grown_bounds(bounds, amount)
+            Ea::Model::Bounds.new(x: bounds.x - amount, y: bounds.y - amount,
+                                  width: bounds.width + 2 * amount,
+                                  height: bounds.height + 2 * amount)
+          end
+
+          def association_ray_candidate?(model, link_row)
+            model.connector_type == "Association" && link_row.path.to_s.empty? &&
+              model.has_geometry_offsets && model.source_port && model.target_port &&
+              association_ray_style?(model.style.to_h)
+          end
+
+          def association_ray_style?(style)
+            style[:mode] == "3" && !style[:tree] && %w[0 2].include?(style[:lwidth]) &&
+              %i[direct regenerated].none? { |key| style.key?(key) }
+          end
+
+          # Width-0 origins are whole pixels while EA's box centers may sit
+          # on a half pixel. An origin on its border then clips differently
+          # unless the line is axis-aligned, which no rounding changes.
+          def sub_pixel_safe_origins?(origins, boxes)
+            first, last = origins
+            axis_aligned = first.x == last.x || first.y == last.y
+            axis_aligned || origins.none? { |point| boxes.any? { |box| on_border?(point, box) } }
+          end
+
+          def on_border?(point, bounds)
+            [bounds.x, bounds.x + bounds.width].include?(point.x) ||
+              [bounds.y, bounds.y + bounds.height].include?(point.y)
+          end
+
+          def inside_box?(point, bounds)
+            point.x.between?(bounds.x, bounds.x + bounds.width) &&
+              point.y.between?(bounds.y, bounds.y + bounds.height)
+          end
+
+          # A Mode 2 Association with equal SX/EX (vertical EDGE 1/3) or
+          # equal SY/EY (horizontal EDGE 4) and no custom Path docks as a
+          # straight line through the middle of the boxes' overlap, moved
+          # by the shared stored offset. Stored SY counts upward.
+          def overlap_ray_origins(model, link_row, diagram_row, geom, context)
+            return model if context
+            return model unless overlap_ray_candidate?(model, link_row, geom)
+
+            source, target = stored_ray_boxes(link_row, diagram_row)
+            origins = overlap_origins(source, target, geom)
+            return model unless origins
+
+            model.source_anchor, model.target_anchor = origins.map do |ox, oy|
+              Ea::Model::Point.new(x: ox, y: oy)
+            end
+            model.style[:overlap_ray] = true
+            model
+          end
+
+          # Both ray origins share the overlap coordinate on the axis the
+          # offsets move and sit at each box's centre on the other axis.
+          def overlap_origins(source, target, geom)
+            along, across, offset = overlap_axes(geom)
+            coordinate = overlap_ray_coordinate(*box_span(source, along), *box_span(target, along), offset)
+            return nil unless coordinate && disjoint_span?(*box_span(source, across), *box_span(target, across))
+
+            [source, target].map do |box|
+              start, size = box_span(box, across)
+              centre = start + size / 2.0
+              geom[:edge] == 4 ? [centre, coordinate] : [coordinate, centre]
+            end
+          end
+
+          # [axis the offsets move, axis the boxes face, stored offset]
+          def overlap_axes(geom)
+            return [%i[y height], %i[x width], -geom[:sy]] if geom[:edge] == 4
+
+            [%i[x width], %i[y height], geom[:sx]]
+          end
+
+          def box_span(box, keys)
+            keys.map { |key| box.public_send(key) }
+          end
+
+          def overlap_ray_candidate?(model, link_row, geom)
+            model.connector_type == "Association" && model.style[:mode] == "2" &&
+              model.waypoints.size == 2 && link_row.path.to_s.empty? &&
+              model.has_geometry_offsets && uniform_overlap_offsets?(geom)
+          end
+
+          def uniform_overlap_offsets?(geom)
+            return false unless geom.values_at(:sx, :sy, :ex, :ey).all?
+
+            geom[:edge] == 4 ? geom[:sy] == geom[:ey] : [1, 3].include?(geom[:edge]) && geom[:sx] == geom[:ex]
+          end
+
+          # Floor of the overlap midpoint plus the shared offset; nil
+          # when the boxes do not overlap on this axis.
+          def overlap_ray_coordinate(start_a, size_a, start_b, size_b, offset)
+            low = [start_a, start_b].max
+            high = [start_a + size_a, start_b + size_b].min
+            return nil if low > high
+
+            coordinate = ((low + high) / 2.0 + offset).floor
+            coordinate if coordinate.between?(low, high)
+          end
+
+          def disjoint_span?(start_a, size_a, start_b, size_b)
+            start_a + size_a < start_b || start_b + size_b < start_a
+          end
+
           def stored_ray_boxes(link_row, diagram_row)
             connector = database.find_connector(link_row.connectorid)
             [source_placement_for(connector, diagram_row),
@@ -134,7 +327,7 @@ module Ea
 
             case connector.connector_type
             when "Aggregation"
-              return if geometry_has_offsets?(link_row.geometry)
+              return unless style[:lwidth] == "0" || !geometry_has_offsets?(link_row.geometry)
 
               redock_child_below(points, bounds_from_rect(source_placement), bounds_from_rect(target_placement))
             when "Association"
@@ -174,6 +367,14 @@ module Ea
             route
           end
 
+          # One stored corner that is level with both boxes already is the
+          # route (vertical leg out of the source, horizontal leg into the
+          # target); flattening it to the facing edges would lose it.
+          def level_corner_route?(points, link_row, connector, src, tgt)
+            points.size == 3 && level_entry_style?(link_row, connector) &&
+              !level_entry_point(points[1], src).nil? && !level_entry_point(points[1], tgt).nil?
+          end
+
           def level_entry_style?(link_row, connector)
             style = DiagramStyleParser.parse(link_row.style)
             %w[Generalization Aggregation].include?(connector.connector_type) &&
@@ -241,6 +442,62 @@ module Ea
               [bounds.y, bounds.y + bounds.height].include?(point[1])
           end
 
+          # A width-2 Mode 3 Aggregation without a tree style keeps an authored
+          # orthogonal stair-step of three or more corners. Each end docks on
+          # the 1px outline its adjacent leg points at, from the corner's own
+          # coordinate; any end that cannot do so leaves the route unchanged.
+          def stored_stair_route(link_row, connector, source, target)
+            return nil unless stair_style?(link_row, connector)
+
+            corners = stored_square_corners(link_row)
+            return nil unless corners && corners.size >= 3 && alternating_legs?(corners)
+
+            first = outline_dock(corners[0], corners[1], source)
+            last = outline_dock(corners[-1], corners[-2], target)
+            [first, *corners, last] if first && last
+          end
+
+          def stair_style?(link_row, connector)
+            style = DiagramStyleParser.parse(link_row.style)
+            connector.connector_type == "Aggregation" && style[:mode] == "3" &&
+              style[:lwidth] == "2" && !style.key?(:tree)
+          end
+
+          # Every leg is non-zero and runs along the opposite axis of the last.
+          def alternating_legs?(corners)
+            axes = corners.each_cons(2).map { |from, to| leg_axis(from, to) }
+            axes.none?(&:nil?) && axes.each_cons(2).all? { |a, b| a != b }
+          end
+
+          def leg_axis(from, to)
+            return :vertical if from[0] == to[0] && from[1] != to[1]
+
+            :horizontal if from[1] == to[1] && from[0] != to[0]
+          end
+
+          # The dock runs perpendicular to the corner's own leg.
+          def outline_dock(corner, neighbour, box)
+            if corner[1] == neighbour[1]
+              vertical_outline_dock(corner, box)
+            else
+              horizontal_outline_dock(corner, box)
+            end
+          end
+
+          def vertical_outline_dock(corner, box)
+            x, y = corner
+            return nil unless x.between?(box.x, box.x + box.width) && !within_height?(y, box)
+
+            [x, y < box.y ? box.y - 1 : box.y + box.height + 1]
+          end
+
+          def horizontal_outline_dock(corner, box)
+            x, y = corner
+            return nil unless within_height?(y, box) && !x.between?(box.x, box.x + box.width)
+
+            [x < box.x ? box.x - 1 : box.x + box.width + 1, y]
+          end
+
           # A valid lateral corner joins one vertical leg and one horizontal
           # leg. Keep it even when the boxes also admit a shorter direct route.
           # ported: both ends carry explicit SX/SY and EX/EY offsets. An
@@ -255,6 +512,66 @@ module Ea
             corner && lateral_corner_route(style, corner, source, target)
           end
 
+          # A horizontal lateral tree with no usable stored corner leaves
+          # the source's top or bottom edge at its center x, turns at the
+          # target's center y and enters the target's facing side edge.
+          # When that y lies inside the source's height the route is one
+          # horizontal line between the facing side edges. Every dock is
+          # flush on its box edge.
+          def derived_lateral_route(link_row, connector, source, target)
+            style = DiagramStyleParser.parse(link_row.style)
+            return nil unless style[:mode] == "3" && style[:tree] == "LH" &&
+                              derived_lateral_path?(connector.connector_type, link_row.path.to_s)
+
+            x = source.x + source.width / 2
+            y = target.y + target.height / 2
+            edge = lateral_target_edge(x, target)
+            return nil unless edge
+
+            if within_height?(y, source)
+              side = target.x > x ? source.x + source.width : source.x
+              [[side, y], [edge, y]] if ((edge - side) * (edge - x)).positive?
+            else
+              [[x, y < source.y ? source.y : source.y + source.height], [x, y], [edge, y]]
+            end
+          end
+
+          # An Association may carry one stored corner that no valid lateral
+          # route accepted; a Generalization derives only from an empty Path.
+          def derived_lateral_path?(connector_type, path)
+            case connector_type
+            when "Association" then path.match?(/\A(?:-?\d+:-?\d+;?)?\z/)
+            when "Generalization" then path.empty?
+            else false
+            end
+          end
+
+          # A derived level line docks flush at its own two ends; anchoring
+          # the ray there keeps the emitter's clip from moving them.
+          def pin_derived_lateral_line(model, link_row, diagram_row, context)
+            style = model.style.to_h
+            return model if context || model.waypoints.size != 2 ||
+                            style[:mode] != "3" || style[:tree] != "LH"
+
+            source, target = stored_ray_boxes(link_row, diagram_row)
+            connector = database.find_connector(link_row.connectorid)
+            line = connector && derived_lateral_route(link_row, connector, source, target)
+            return model unless line && line.size == 2 &&
+                                line == model.waypoints.map { |wp| [wp.position.x, wp.position.y] }
+
+            model.source_anchor, model.target_anchor = line.map { |x, y| Ea::Model::Point.new(x: x, y: y) }
+            model.style = style.merge(derived_lateral_line: true)
+            model
+          end
+
+          # The target side edge a vertical leg at x faces, or nil when x
+          # lies within the target's span.
+          def lateral_target_edge(x_position, target)
+            return target.x if x_position < target.x
+
+            target.x + target.width if x_position > target.x + target.width
+          end
+
           # An untyped Mode 3 Association corner takes whichever leg
           # orientation its position fits; width-2 docks sit on the 1px
           # outer outline.
@@ -334,14 +651,13 @@ module Ea
           # Keep a vertical tree trunk whose bends still fit both boxes
           # and the open gap; the closest facing edges need not share its x.
           def preserve_stored_tree?(points, link_row, connector, src, tgt)
-            return false unless connector.connector_type == "Aggregation" && points.size == 4
+            return false unless points.size == 4 && stored_tree_type?(points, link_row, connector)
 
             style = DiagramStyleParser.parse(link_row.style)
             return false unless style[:lwidth] == "2" || flush_width_zero_tree?(link_row)
-            return false unless style[:tree] == "V" ||
-                                (style[:mode] == "3" && style[:tree].nil?)
+            return false unless vertical_tree_style?(style)
 
-            tree_bends_fit?(points[1], points[-2], src, tgt)
+            tree_bends_fit?(points[1], points[-2], src, tgt, flush_width_zero_tree?(link_row))
           end
 
           # A width-2 Mode 3 horizontal tree keeps its stored vertical trunk
@@ -412,6 +728,70 @@ module Ea
             model
           end
 
+          # Same one-pixel collapse for a two-waypoint computed line when only
+          # the target carries an explicit port (the source end is the default
+          # edge midpoint): the left-hand end's y wins.
+          def collapse_partial_port_jog(model, link_row, diagram_row)
+            return model unless partial_port_jog_candidate?(model, link_row)
+
+            connection = database.find_connector(link_row.connectorid)
+            src, tgt = [connection.start_object_id, connection.end_object_id].map do |id|
+              placement = diagram_object_placement(diagram_row.diagram_id, id)
+              placement && bounds_from_rect(placement)
+            end
+            from, to = model.waypoints.map(&:position)
+            return model unless src && tgt && facing_jog_ports?(from, to, src, tgt)
+
+            level = [from, to].min_by(&:x).y
+            ends = [[from.x, level], [to.x, level]].map do |x, y|
+              Ea::Model::Point.new(x: x, y: y)
+            end
+            model.waypoints = ends.map { |point| Ea::Model::Waypoint.new(position: point) }
+            model.source_anchor = model.source_port = ends.first
+            model.target_anchor = model.target_port = ends.last
+            model
+          end
+
+          # A two-waypoint Mode 3 Aggregation with only a target port draws the
+          # line from the source center to the target's stored ray origin
+          # (center + EX, center - EY), clipped at the outlines; the boundary
+          # port is only the derived crossing of that origin's ray.
+          def correct_partial_port_origins(model, link_row, diagram_row, geom, context)
+            return model if context || !partial_port_origin_candidate?(model, link_row)
+
+            source, target = stored_ray_boxes(link_row, diagram_row)
+            return model unless horizontal_ray_gap?(source, target)
+
+            model.source_anchor = stored_ray_origin(source, 0, 0)
+            model.target_anchor = stored_ray_origin(target, geom[:ex], geom[:ey])
+            model
+          end
+
+          def partial_port_origin_candidate?(model, link_row)
+            style = model.style.to_h
+            model.connector_type == "Aggregation" && model.waypoints.size == 2 &&
+              link_row.path.to_s.empty? && style[:mode] == "3" && style[:lwidth] == "2" &&
+              !style.key?(:tree) &&
+              model.source_port.nil? && model.target_port
+          end
+
+          def partial_port_jog_candidate?(model, link_row)
+            style = model.style.to_h
+            model.connector_type == "Aggregation" &&
+              link_row.path.to_s.empty? && style[:mode] == "3" &&
+              !style.key?(:tree) && model.waypoints.size == 2 &&
+              explicit_port_side?(model, style[:lwidth])
+          end
+
+          # Width 2 keeps the evidenced target-only port; width 0 accepts a
+          # single explicit port at either end.
+          def explicit_port_side?(model, width)
+            ports = [model.source_port, model.target_port]
+            return model.source_port.nil? && !model.target_port.nil? if width == "2"
+
+            width == "0" && ports.compact.size == 1
+          end
+
           def computed_jog_candidate?(model, link_row, geom)
             style = model.style.to_h
             model.connector_type == "Generalization" && geom[:edge] == 2 &&
@@ -438,14 +818,32 @@ module Ea
             style[:mode] == "3" && style[:tree] == "V" && style[:lwidth] == "0"
           end
 
-          def tree_bends_fit?(first, last, source, target)
-            first[0] != last[0] && first[1] == last[1] &&
-              within_vertical_gap?(first[1], source, target) &&
+          def vertical_tree_style?(style)
+            style[:tree] == "V" || (style[:mode] == "3" && style[:tree].nil?)
+          end
+
+          def stored_tree_type?(points, link_row, connector)
+            connector.connector_type == "Aggregation" || flush_straight_association?(points, link_row, connector)
+          end
+
+          # A flush Association keeps only a straight trunk (one bend stored twice).
+          def flush_straight_association?(points, link_row, connector)
+            connector.connector_type == "Association" && points[1] == points[-2] &&
+              flush_width_zero_tree?(link_row)
+          end
+
+          # A flush trunk may also hang below its parent; a bend repeated at
+          # one x is a straight trunk with a single bend.
+          def tree_bends_fit?(first, last, source, target, flush)
+            first[1] == last[1] &&
+              within_vertical_gap?(first[1], source, target, flush) &&
               within_horizontal_span?(first, source) && within_horizontal_span?(last, target)
           end
 
-          def within_vertical_gap?(height, source, target)
-            height < source.y - 1 && height > target.y + target.height + 1
+          def within_vertical_gap?(height, source, target, flush)
+            return true if height < source.y - 1 && height > target.y + target.height + 1
+
+            flush && height > source.y + source.height + 1 && height < target.y - 1
           end
 
           def within_horizontal_span?(point, bounds)

data/lib/ea/sources/qea/diagram_builder.rb

@@ -362,12 +362,20 @@ module Ea
             target_stereotype: conn.deststereotype,
             waypoints: waypoints,
             label_boxes: DEFAULT_LABEL_BOXES,
-            style: PHANTOM_DOUBLE_BACK_TYPES.include?(conn.connector_type) ? { direct: true } : {},
+            style: phantom_style(conn.connector_type),
             hidden: false,
             has_geometry_offsets: false
           )
         end
 
+        # Internal producer flag, like :direct. A model relationship with no
+        # link row is stroked at the 2px box outline, so its ends dock there.
+        def phantom_style(connector_type)
+          return { direct: true } if PHANTOM_DOUBLE_BACK_TYPES.include?(connector_type)
+
+          %w[Aggregation Association].include?(connector_type) ? { phantom_outline: true } : {}
+        end
+
         # Computes the edge attachment point on source bounds that
         # faces the target bounds. Uses the center-to-center direction
         # to pick the nearest edge intersection.
@@ -421,8 +429,14 @@ module Ea
             has_geometry_offsets: geometry_has_offsets?(link_row.geometry),
             is_substitutable: substitutable_connector?(connector)
           ), link_row, diagram_row, geom)
+          model = collapse_partial_port_jog(model, link_row, diagram_row)
+          model = correct_partial_port_origins(model, link_row, diagram_row, geom, context)
           model = direct_empty_path_ray(model, link_row, diagram_row, geom, context)
-          correct_stored_ray_origins(model, link_row, diagram_row, geom, context)
+          model = pin_derived_lateral_line(model, link_row, diagram_row, context)
+          model = mode2_overlap_ray(model, link_row, diagram_row, geom, context)
+          model = association_stored_ray(model, link_row, diagram_row, geom, context)
+          model = correct_stored_ray_origins(model, link_row, diagram_row, geom, context)
+          overlap_ray_origins(model, link_row, diagram_row, geom, context)
         end
 
         # Ray origin for one connector end: the element's center
@@ -662,15 +676,17 @@ module Ea
           src = bounds_from_rect(source_placement)
           tgt = bounds_from_rect(target_placement)
           tree_route = stored_square_route(link_row, connector, src, tgt) ||
+                       stored_stair_route(link_row, connector, src, tgt) ||
                        stored_lateral_route(link_row, connector, src, tgt,
                                             ported: source_port && target_port) ||
+                       derived_lateral_route(link_row, connector, src, tgt) ||
                        horizontal_tree_route(points, link_row, connector, src, tgt)
           if tree_route
             points = tree_route
           elsif %w[Association Aggregation].include?(connector.connector_type) &&
                 edge_out != 2
             stored_tree = preserve_stored_tree?(points, link_row, connector, src, tgt)
-            unless stored_tree
+            unless stored_tree || level_corner_route?(points, link_row, connector, src, tgt)
               points = facing_edge_route(points, src, tgt)
             end
             # A width-2 Aggregation that keeps its stored bends is

data/lib/ea/svg/ea_emitter/connector_redock.rb

@@ -39,10 +39,15 @@ module Ea
             return target && [points[0], points[1], target]
           end
 
+          return nil if flush_lateral_line?(connector, points, source_bounds, target_bounds)
+
           anchors = [connector.source_anchor, connector.target_anchor]
           bounds = [source_bounds, target_bounds]
           original = clipped_pairs(bounds, anchors)
-          return original unless stroke_outline?(connector, bounds)
+          unless stroke_outline?(connector, bounds) || overlap_ray?(connector) ||
+                 bordered_outline?(connector, diagram, [source_ref, target_ref], bounds)
+            return original
+          end
 
           # EA docks these markers on the outer edge of the 2px box stroke.
           outline = bounds.map do |box|
@@ -53,6 +58,29 @@ module Ea
           forward_route?(original, candidate) ? candidate : original
         end
 
+        # A horizontal lateral tree the QEA builder derived as one level
+        # line (internal style flag) keeps it between the facing side edges.
+        def flush_lateral_line?(connector, points, source, target)
+          style = connector.style.to_h
+          return false unless style[:derived_lateral_line] && style[:mode] == "3" &&
+                              style[:tree] == "LH" && points.size == 2 &&
+                              %w[Association Generalization].include?(connector.connector_type)
+          return false unless connector.source_anchor && connector.target_anchor
+
+          first, last = points
+          pinned = [[connector.source_anchor.x, connector.source_anchor.y],
+                    [connector.target_anchor.x, connector.target_anchor.y]]
+          pinned == [first, last] && first[1] == last[1] &&
+            on_side_edge?(first, source) && on_side_edge?(last, target)
+        end
+        private_class_method :flush_lateral_line?
+
+        def on_side_edge?(point, bounds)
+          [bounds.x, bounds.x + bounds.width].include?(point[0]) &&
+            point[1].between?(bounds.y, bounds.y + bounds.height)
+        end
+        private_class_method :on_side_edge?
+
         def lateral_tree?(connector, points)
           style = connector.style.to_h
           points.size == 3 && style[:mode] == "3" && style[:lwidth] == "2" &&
@@ -97,15 +125,56 @@ module Ea
         private_class_method :facing_coordinate
 
         def stroke_outline?(connector, bounds)
-          connector.style.to_h[:lwidth] == "2" &&
+          (connector.style.to_h[:lwidth] == "2" || default_model_connector?(connector)) &&
             bounds.all? { |box| box.width.positive? && box.height.positive? } &&
             outline_connector?(connector, bounds)
         end
         private_class_method :stroke_outline?
 
+        # The QEA builder marks the Mode 2 Association overlap rays it
+        # produced; EA docks them on the outer stroke edge whatever the
+        # line width. Naturally aligned centres keep the legacy docking.
+        def overlap_ray?(connector)
+          connector.connector_type == "Association" && connector.style.to_h[:overlap_ray] == true
+        end
+        private_class_method :overlap_ray?
+
+        # The QEA builder flags a model relationship drawn without any
+        # diagram link row; EA strokes it at the 2px box outline.
+        def default_model_connector?(connector)
+          connector.style.to_h[:phantom_outline] == true && !connector.has_geometry_offsets &&
+            %w[Aggregation Association].include?(connector.connector_type)
+        end
+        private_class_method :default_model_connector?
+
+        # A thin straight Generalization/Aggregation/Association between two elements
+        # drawn with a 2px border stops on the outer edge of those borders.
+        def bordered_outline?(connector, diagram, refs, bounds)
+          style = connector.style.to_h
+          return false unless style[:lwidth] == "0" && !style[:tree]
+          return false unless %w[Generalization Aggregation Association].include?(connector.connector_type)
+          return false unless bounds.all? { |box| box.width.positive? && box.height.positive? }
+
+          ends = [[refs.first, style[:soid]], [refs.last, style[:eoid]]]
+          ends.all? { |ref, duid| border_two?(diagram, ref, duid) }
+        end
+        private_class_method :bordered_outline?
+
+        # Every placement of the element (the DUID-matched one when the
+        # connector names it) must declare a border width of 2.
+        def border_two?(diagram, ref, duid)
+          placed = Array(diagram&.elements).select { |el| el.model_element_ref == ref }
+          named = placed.select { |el| duid && el.duid.to_s.casecmp?(duid.to_s) }
+          placed = named unless named.empty?
+          placed.any? && placed.all? { |el| el.line_width == 2 || el.style.to_h[:lwth] == "2" }
+        end
+        private_class_method :border_two?
+
         def outline_connector?(connector, bounds)
+          return true if default_model_connector?(connector)
           return true if %w[Generalization Aggregation].include?(connector.connector_type)
 
+          return true if association_ray_outline?(connector)
           return false unless stored_association?(connector) || offset_free_association?(connector)
 
           # Diagonal Association rounding and tree docks keep their existing rules.
@@ -114,6 +183,15 @@ module Ea
         end
         private_class_method :outline_connector?
 
+        # The QEA builder marks the stored Association rays it produced;
+        # their diagonal docks sit on the outer stroke edge like the
+        # axis-aligned ones. Unmarked diagonals keep the legacy docking.
+        def association_ray_outline?(connector)
+          connector.connector_type == "Association" &&
+            connector.style.to_h[:association_ray_outline] == true
+        end
+        private_class_method :association_ray_outline?
+
         def stored_association?(connector)
           style = connector.style.to_h
           connector.connector_type == "Association" && connector.has_geometry_offsets &&
@@ -197,6 +275,7 @@ module Ea
                             bounds_map, divider_y_by_ref)
           return nil unless bounds_map && divider_y_by_ref
           return nil unless pairs.size == 2
+          return nil if explicit_association_ray?(pairs, connector)
 
           rel = relationship_for(connector, model_index)
           return nil unless rel
@@ -231,16 +310,36 @@ module Ea
         end
         private_class_method :explicit_horizontal_source_dock?
 
-        def explicit_horizontal_ray?(connector)
-          explicit_horizontal_ray_style?(connector) && connector.has_geometry_offsets &&
+        # A stored Association ray whose source port certifies the shared
+        # anchor row is one explicit horizontal line: EA seats neither end
+        # in a compartment row, unlike Generalization/Aggregation targets.
+        def explicit_association_ray?(pairs, connector)
+          produced = connector.style.to_h[:stored_association_ray] == true
+          return true if produced && pairs.first[1] == pairs.last[1]
+
+          certified_association_ray?(pairs, connector)
+        end
+
+        def certified_association_ray?(pairs, connector)
+          return false unless explicit_horizontal_ray?(connector, %w[Association])
+
+          connector.source_anchor.y == connector.target_anchor.y &&
+            connector.source_port.y == connector.source_anchor.y &&
+            pairs.first[1] == pairs.last[1]
+        end
+        private_class_method :certified_association_ray?
+        private_class_method :explicit_association_ray?
+
+        def explicit_horizontal_ray?(connector, types = %w[Generalization Aggregation])
+          explicit_horizontal_ray_style?(connector, types) && connector.has_geometry_offsets &&
             connector.source_port && connector.target_port &&
             connector.source_anchor && connector.target_anchor
         end
         private_class_method :explicit_horizontal_ray?
 
-        def explicit_horizontal_ray_style?(connector)
+        def explicit_horizontal_ray_style?(connector, types)
           style = connector.style.to_h
-          %w[Generalization Aggregation].include?(connector.connector_type) &&
+          types.include?(connector.connector_type) &&
             style[:mode] == "3" && !style[:tree] && !style[:direct] && !style[:regenerated]
         end
         private_class_method :explicit_horizontal_ray_style?

data/lib/ea/version.rb

@@ -4,5 +4,5 @@ module Ea
   # Gem release version. Extracted to its own file so the
   # `gem-release` tool's `gem bump` can find and update it via the
   # standard `lib/<gem>/version.rb` convention.
-  VERSION = "0.6.99"
+  VERSION = "0.6.101"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ea
 version: !ruby/object:Gem::Version
-  version: 0.6.99
+  version: 0.6.101
 platform: ruby
 authors:
 - Ribose Inc.