metadata_presenter 2.4.0 → 2.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e32a28102541813aa8d6576cafdaa6fb3b4897daee023f0e52d80b1c98c3266f
-  data.tar.gz: 2001211cd3395cff6b2dc4d4f806f7055267c0a448d4316a5da6998d1ebe5295
+  metadata.gz: d4711e7f1519315b8e0e2bbe067598fedf285ac167b16f47ed48aa73e60710ff
+  data.tar.gz: 5ac9f6c8c6ae1831ca3e0fa985fc54c8151cd7ae39d6590ff9e548169c3f1125
 SHA512:
-  metadata.gz: 40bbe63a448710146762e167f0abc415e39028d1e279bdf72aa989376abbae4881d56d2cfbcc065805541f6a340a39349a7d5ccb3efd9b6444b803ea5d21ebfc
-  data.tar.gz: 48902563f8e43de68352ce31c47d554493a4add994649c54d1933062a7cec78c7334c20debf05fea827f84dd825bf16bb1c1b34fa033733e877d964c94f3c2a2
+  metadata.gz: 4dc54e3ecbb88210ce1d14211f89ebb063a31413dc733a5376e59b685f8a07dee9db1758c9933fa310cd94d5c953bed6f0aea8e0518bccb0fc75a67f65b422ab
+  data.tar.gz: 2824f22e9c5e15d63b59abfbf28c3679115b1430c646115c0c9e336dfba2b1f575e0a538e3e79058d4ae4ff5d917d50ba596bc3913acd549b65c56eb13f9f328

data/app/models/metadata_presenter/flow.rb

@@ -16,6 +16,10 @@ module MetadataPresenter
       metadata['next']['default']
     end
 
+    def all_destination_uuids
+      conditionals.map(&:next).append(default_next)
+    end
+
     def conditionals
       Array(metadata['next']['conditionals']).map do |conditional_metadata|
         Conditional.new(conditional_metadata)

data/app/models/metadata_presenter/grid.rb

@@ -0,0 +1,203 @@
+module MetadataPresenter
+  class Spacer < OpenStruct
+  end
+
+  class Grid
+    def initialize(service)
+      @service = service
+      @ordered = []
+      @routes = []
+      @traversed = []
+      @coordinates = setup_coordinates
+    end
+
+    ROW_ZERO = 0
+
+    def build
+      return @ordered unless @ordered.empty?
+
+      @ordered = make_grid
+      add_columns
+      add_rows
+      add_by_coordinates
+      insert_expression_spacers
+      trim_spacers
+
+      @ordered
+    end
+
+    def ordered_flow
+      @ordered_flow ||=
+        build.flatten.reject { |obj| obj.is_a?(MetadataPresenter::Spacer) }
+    end
+
+    def ordered_pages
+      ordered_flow.reject(&:branch?)
+    end
+
+    private
+
+    attr_reader :service
+    attr_accessor :ordered, :traversed, :routes, :coordinates
+
+    def setup_coordinates
+      service.flow.keys.index_with { |_uuid| { row: nil, column: nil } }
+    end
+
+    def route_from_start
+      @route_from_start ||=
+        MetadataPresenter::Route.new(
+          service: service,
+          traverse_from: service.start_page.uuid
+        )
+    end
+
+    def make_grid
+      traverse_all_routes
+
+      rows = @routes.map(&:row).max
+      columns = @routes.map { |r| r.column + r.flow_uuids.count }.max
+      columns.times.map { rows.times.map { MetadataPresenter::Spacer.new } }
+    end
+
+    def traverse_all_routes
+      # Always traverse the route that begins from the start page first and get
+      # the potential routes from any branching points that exist.
+      route_from_start.traverse
+      @routes.append(route_from_start)
+      traversed_routes = route_from_start.routes
+
+      index = 0
+      until traversed_routes.empty?
+        if index > total_potential_routes
+          ActiveSupport::Notifications.instrument(
+            'exceeded_total_potential_routes',
+            message: 'Exceeded total number of potential routes'
+          )
+          break
+        end
+
+        route = traversed_routes.shift
+        @routes.append(route)
+
+        # Every route exiting a branching point needs to be traversed and any
+        # additional routes from other branching points collected and then also
+        # traversed.
+        route.traverse
+        traversed_routes |= route.routes
+
+        index += 1
+      end
+    end
+
+    def add_columns
+      @routes.each do |route|
+        route.flow_uuids.each.with_index(route.column) do |uuid, column|
+          column_number = @coordinates[uuid][:column]
+          if column_number.nil? || column > column_number
+            @coordinates[uuid][:column] = column
+          end
+        end
+      end
+    end
+
+    def add_rows
+      @routes.each do |route|
+        route.flow_uuids.each do |uuid|
+          next if @traversed.include?(uuid)
+
+          @coordinates[uuid][:row] = route.row if @coordinates[uuid][:row].nil?
+
+          update_route_rows(route, uuid)
+          @traversed.push(uuid)
+        end
+      end
+    end
+
+    # Each Route object has a starting row. Each Route object has no knowledge
+    # of other potential routes and pages/branches that may or may not exist in
+    # them. The starting row may need to change dependent upon what has been
+    # traversed in other routes.
+    def update_route_rows(route, uuid)
+      flow_object = service.flow_object(uuid)
+      if flow_object.branch? && route.row > ROW_ZERO
+        destinations = routes_exiting_branch(flow_object)
+        destinations.each.with_index(route.row) do |destination_uuid, row|
+          @routes.each do |r|
+            r.row = row if r.traverse_from == destination_uuid
+          end
+        end
+      end
+    end
+
+    def add_by_coordinates
+      @coordinates.each do |uuid, position|
+        # If row and column are nil then the object is detached
+        next if position[:row].nil? || position[:column].nil?
+
+        flow_object = service.flow_object(uuid)
+        @ordered[position[:column]][position[:row]] = flow_object
+      end
+    end
+
+    # Find the very last MetadataPresenter::Flow object in every column and
+    # remove any Spacer objects after that.
+    def trim_spacers
+      @ordered.each_with_index do |column, index|
+        last_index_of = column.rindex { |item| item.is_a?(MetadataPresenter::Flow) }
+        @ordered[index] = @ordered[index][0..last_index_of]
+      end
+    end
+
+    # Each branch has a certain number of exits that require their own line
+    # and arrow. Insert any spacers into the necessary row in the column after
+    # the one the branch is located in.
+    def insert_expression_spacers
+      service.branches.each do |branch|
+        position = @coordinates[branch.uuid]
+        next if position[:row].nil? || position[:column].nil? # detached branch
+
+        next_column = position[:column] + 1
+        uuids = []
+        exiting_destinations_from_branch(branch).each.with_index(position[:row]) do |uuid, row|
+          if uuids.include?(uuid)
+            @ordered[next_column].insert(row, MetadataPresenter::Spacer.new)
+          end
+
+          uuids.push(uuid) unless uuids.include?(uuid)
+        end
+      end
+    end
+
+    # The frontend requires that expressions of type 'or' get there own line and
+    # arrow. 'and' expression types continue to be grouped together.
+    # Return the UUIDs of the destinations exiting a branch and allow duplicates
+    # if the expression type is an 'or'.
+    def exiting_destinations_from_branch(branch)
+      destination_uuids = branch.conditionals.map do |conditional|
+        if conditional.type == 'or'
+          conditional.expressions.map(&:next)
+        else
+          conditional.next
+        end
+      end
+      destination_uuids.flatten
+    end
+
+    # Any destinations exiting the branch that have not already been traversed.
+    def routes_exiting_branch(branch)
+      branch.all_destination_uuids.reject { |uuid| @traversed.include?(uuid) }
+    end
+
+    # Deliberately not including the default next for each branch as when row
+    # zero is created it takes the first available conditional for each branch.
+    # The remaining are then used to create route objects. Therefore the total
+    # number of remaining routes will be the same as the total of all the branch
+    # conditionals.
+    # Add 1 additional route as that represents the route_from_start.
+    def total_potential_routes
+      @total_potential_routes ||=
+        service.branches.sum { |branch| branch.conditionals.size } + 1
+    end
+  end
+end

data/app/models/metadata_presenter/page.rb

@@ -13,6 +13,12 @@ module MetadataPresenter
       add_extra_component
     ].freeze
     QUESTION_PAGES = %w[page.singlequestion page.multiplequestions].freeze
+    USES_HEADING = %w[
+      page.content
+      page.checkanswers
+      page.confirmation
+      page.multiplequestions
+    ].freeze
 
     def editable_attributes
       to_h.reject { |k, _| k.in?(NOT_EDITABLE) }
@@ -87,8 +93,7 @@ module MetadataPresenter
     private
 
     def heading?
-      Array(components).size != 1 ||
-        type.in?(['page.content', 'page.checkanswers', 'page.confirmation'])
+      type.in?(USES_HEADING) || Array(components).size != 1
     end
 
     def to_components(node_components, collection:)

data/app/models/metadata_presenter/route.rb

@@ -0,0 +1,76 @@
+module MetadataPresenter
+  class Route
+    attr_reader :traverse_from
+    attr_accessor :flow_uuids, :routes, :row, :column
+
+    def initialize(service:, traverse_from:, row: 0, column: 0)
+      @service = service
+      @traverse_from = traverse_from
+      @row = row
+      @column = column
+      @routes = []
+      @flow_uuids = []
+    end
+
+    def traverse
+      @flow_uuid = traverse_from
+
+      index = column
+      until @flow_uuid.blank?
+        if index > service.flow.size
+          ActiveSupport::Notifications.instrument(
+            'exceeded_total_flow_objects',
+            message: 'Exceeded total number of flow objects'
+          )
+          break
+        end
+
+        @flow_uuids.push(@flow_uuid) unless @flow_uuids.include?(@flow_uuid)
+        flow_object = service.flow_object(@flow_uuid)
+
+        if flow_object.branch?
+          destinations = destination_uuids(flow_object)
+          # Take the first conditional destination and follow that until the end
+          # of the route.
+          @flow_uuid = destinations.shift
+
+          # The remaining conditional destinations and the branch's default next
+          # (otherwise) will be the starting point for a new Route object to be
+          # traversed.
+          # The default behaviour is that the next destination will be on the row
+          # below this current route's row. This can be changed under certain
+          # conditions in the Grid model.
+          # Each of the destinations need to be placed in the column after the
+          # current column.
+          row_number = row + 1
+          column_number = index + 1
+          destinations.each do |uuid|
+            @routes.push(
+              MetadataPresenter::Route.new(
+                service: service,
+                traverse_from: uuid,
+                row: row_number,
+                column: column_number
+              )
+            )
+            row_number += 1
+          end
+        else
+          @flow_uuid = flow_object.default_next
+        end
+
+        index += 1
+      end
+
+      @flow_uuids
+    end
+
+    private
+
+    attr_reader :service
+
+    def destination_uuids(flow_object)
+      flow_object.conditionals.map(&:next).push(flow_object.default_next)
+    end
+  end
+end