cocina_display 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ef43e2d573c99c10d6db87974ff32091ff7e7d312bf2e812ef1043f513f291c
-  data.tar.gz: f04b35117201aaebff5e8d041d2776525dcd18a46bc408baf9d8649376d90618
+  metadata.gz: 0724f307088c9cdd9348af463e3c659811eef65d0f1f04e094b4c664a36cfed1
+  data.tar.gz: 4b49472d07a085455ca72204e6ebde3cfc27c634f8ba9cd5b2c2a47d62d19aad
 SHA512:
-  metadata.gz: c36dd129d129ce44c7c516b670295b59f68732d0270664dda63ce119fe37ec60e68c6fd615e37ada5ecef06777db7be30cd708d0f0c461c18c97085e98eb553f
-  data.tar.gz: cddd56237670d908a6be7951e24fe62a0fbd3076fd0eff96693c7debc03fa9ab8e01157a330923938143ec2067a4d97d4ead339f44fd2b00d0bcf99ea92b6af0
+  metadata.gz: edc1e8977792d21fd6fef292f486c11eab4011dc63c854af1217aced6930ea55538e158abc261491c08b1f8492c374c52102b44931849b2350e1dacf54310d41
+  data.tar.gz: 664691764d4a4ff7da024af64ce9dd2d0841d8c014ee9439c3ebebe4b3a4c2e585e7f608f2ff943a04586dfaad8fc4ec7cfa714fade929ca9b0278ec740bff8b

data/README.md

@@ -40,7 +40,7 @@ There is also a helper method to fetch the Cocina JSON for a given DRUID and imm
 The `CocinaRecord` class provides some methods to access common fields, as well as an underlying hash representation parsed from the JSON.
 
 ```ruby
-> record.title
+> record.main_title
 => "Bugatti Type 51A. Road & Track Salon January 1957"
 > record.content_type
 => "image"

data/lib/cocina_display/cocina_record.rb

@@ -7,13 +7,18 @@ require "active_support"
 require "active_support/core_ext/object/blank"
 require "active_support/core_ext/hash/conversions"
 
-require_relative "title_builder"
 require_relative "concerns/events"
+require_relative "concerns/contributors"
+require_relative "concerns/identifiers"
+require_relative "concerns/titles"
 
 module CocinaDisplay
   # Public Cocina metadata for an SDR object, as fetched from PURL.
   class CocinaRecord
     include CocinaDisplay::Concerns::Events
+    include CocinaDisplay::Concerns::Contributors
+    include CocinaDisplay::Concerns::Identifiers
+    include CocinaDisplay::Concerns::Titles
 
     # Fetch a public Cocina document from PURL and create a CocinaRecord.
     # @note This is intended to be used in development or testing only.
@@ -45,60 +50,6 @@ module CocinaDisplay
       Janeway.enum_for(path_expression, cocina_doc)
     end
 
-    # The DRUID for the object, with the +druid:+ prefix.
-    # @return [String]
-    # @example
-    #   record.druid #=> "druid:bb099mt5053"
-    def druid
-      cocina_doc["externalIdentifier"]
-    end
-
-    # The DRUID for the object, without the +druid:+ prefix.
-    # @return [String]
-    # @example
-    #   record.bare_druid #=> "bb099mt5053"
-    def bare_druid
-      druid.delete_prefix("druid:")
-    end
-
-    # The DOI for the object, if there is one – just the identifier part.
-    # @return [String, nil]
-    # @example
-    #   record.doi #=> "10.25740/ppax-bf07"
-    def doi
-      doi_id = path("$.identification.doi").first ||
-        path("$.description.identifier[?match(@.type, 'doi|DOI')].value").first ||
-        path("$.description.identifier[?search(@.uri, 'doi.org')].uri").first
-
-      URI(doi_id).path.delete_prefix("/") if doi_id.present?
-    end
-
-    # The DOI as a URL, if there is one. Any valid DOI should resolve via doi.org.
-    # @return [String, nil]
-    # @example
-    #   record.doi_url #=> "https://doi.org/10.25740/ppax-bf07"
-    def doi_url
-      URI.join("https://doi.org", doi).to_s if doi.present?
-    end
-
-    # The HRID of the item in FOLIO, if defined.
-    # @note This doesn't imply the object is available in Searchworks at this ID.
-    # @return [String, nil]
-    # @example
-    #   record.folio_hrid #=> "a12845814"
-    def folio_hrid
-      path("$.identification.catalogLinks[?(@.catalog == 'folio')].catalogRecordId").first
-    end
-
-    # The FOLIO HRID if defined, otherwise the bare DRUID.
-    # @note This doesn't imply the object is available in Searchworks at this ID.
-    # @see folio_hrid
-    # @see bare_druid
-    # @return [String]
-    def searchworks_id
-      folio_hrid || bare_druid
-    end
-
     # Timestamp when the Cocina was created.
     # @note This is for the metadata itself, not the object.
     # @return [Time]
@@ -128,28 +79,6 @@ module CocinaDisplay
       content_type == "collection"
     end
 
-    # The main title for the object.
-    # @note If you need more formatting control, consider using {CocinaDisplay::TitleBuilder} directly.
-    # @return [String]
-    # @example
-    #   record.title #=> "Bugatti Type 51A. Road & Track Salon January 1957"
-    def title
-      CocinaDisplay::TitleBuilder.build(
-        cocina_doc.dig("description", "title"),
-        catalog_links: cocina_doc.dig("identification", "catalogLinks")
-      )
-    end
-
-    # Alternative or translated titles for the object. Does not include the main title.
-    # @return [Array<String>]
-    # @example
-    #  record.additional_titles #=> ["Alternate title 1", "Alternate title 2"]
-    def additional_titles
-      CocinaDisplay::TitleBuilder.additional_titles(
-        cocina_doc.dig("description", "title")
-      )
-    end
-
     # Traverse nested FileSets and return an enumerator over their files.
     # Each file is a +Hash+.
     # @return [Enumerator] Enumerator over file hashes

data/lib/cocina_display/concerns/contributors.rb

@@ -0,0 +1,94 @@
+require_relative "../contributor"
+
+module CocinaDisplay
+  module Concerns
+    # Methods for finding and formatting names for contributors
+    module Contributors
+      # The main author's name, formatted for display.
+      # @param with_date [Boolean] Include life dates, if present
+      # @return [String]
+      # @return [nil] if no main author is found
+      # @example
+      #   record.main_author #=> "Smith, John"
+      # @example with date
+      #   record.main_author(with_date: true) #=> "Smith, John, 1970-2020"
+      def main_author(with_date: false)
+        main_author_contributor&.display_name(with_date: with_date)
+      end
+
+      # All author names except the main one, formatted for display.
+      # @param with_date [Boolean] Include life dates, if present
+      # @return [Array<String>]
+      def additional_authors(with_date: false)
+        additional_author_contributors.map { |c| c.display_name(with_date: with_date) }
+      end
+
+      # All names of authors who are people, formatted for display.
+      # @param with_date [Boolean] Include life dates, if present
+      # @return [Array<String>]
+      def person_authors(with_date: false)
+        authors.filter(&:person?).map { |c| c.display_name(with_date: with_date) }
+      end
+
+      # All names of non-person authors, formatted for display.
+      # This includes organizations, conferences, families, etc.
+      # @return [Array<String>]
+      # @see https://github.com/sul-dlss/cocina-models/blob/main/docs/description_types.md#contributor-types
+      def impersonal_authors
+        authors.reject(&:person?).map(&:display_name)
+      end
+
+      # All names of authors that are organizations, formatted for display.
+      # @return [Array<String>]
+      def organization_authors
+        authors.filter(&:organization?).map(&:display_name)
+      end
+
+      # All names of authors that are conferences, formatted for display.
+      # @return [Array<String>]
+      def conference_authors
+        authors.filter(&:conference?).map(&:display_name)
+      end
+
+      # A string value for sorting by author that sorts missing values last.
+      # Ignores punctuation and leading/trailing spaces.
+      # @return [String]
+      def sort_author
+        (main_author_contributor&.display_name || "\u{10FFFF}").gsub(/[[:punct:]]*/, "").strip
+      end
+
+      private
+
+      # All contributors for the object, including authors, editors, etc.
+      # @return [Array<Contributor>]
+      def contributors
+        @contributors ||= path("$.description.contributor[*]").map { |c| Contributor.new(c) }
+      end
+
+      # All contributors with a "creator" or "author" role.
+      # @return [Array<Contributor>]
+      # @see Contributor#author?
+      def authors
+        contributors.filter(&:author?)
+      end
+
+      # Contributor object representing the primary author.
+      # Selected according to the following rules:
+      # 1. If there is a primary author or creator, use that.
+      # 2. If there are no primary authors or creators, use the first one.
+      # 3. If there are none at all, use the first contributor without any role.
+      # @return [Contributor]
+      # @return [nil] if no suitable contributor is found
+      def main_author_contributor
+        authors.find(&:primary?).presence || authors.first || contributors.find { |c| !c.role? }.presence
+      end
+
+      # All author/creator contributors except the main one.
+      # @return [Array<Contributor>]
+      def additional_author_contributors
+        return [] if authors.empty? || authors.one? || !authors.include?(main_author_contributor)
+        authors - [main_author_contributor]
+      end
+    end
+  end
+end

data/lib/cocina_display/concerns/identifiers.rb

@@ -0,0 +1,60 @@
+module CocinaDisplay
+  module Concerns
+    # Methods for extracting and formatting identifiers from Cocina records.
+    module Identifiers
+      # The DRUID for the object, with the +druid:+ prefix.
+      # @return [String]
+      # @example
+      #   record.druid #=> "druid:bb099mt5053"
+      def druid
+        cocina_doc["externalIdentifier"]
+      end
+
+      # The DRUID for the object, without the +druid:+ prefix.
+      # @return [String]
+      # @example
+      #   record.bare_druid #=> "bb099mt5053"
+      def bare_druid
+        druid.delete_prefix("druid:")
+      end
+
+      # The DOI for the object, if there is one – just the identifier part.
+      # @return [String, nil]
+      # @example
+      #   record.doi #=> "10.25740/ppax-bf07"
+      def doi
+        doi_id = path("$.identification.doi").first ||
+          path("$.description.identifier[?match(@.type, 'doi|DOI')].value").first ||
+          path("$.description.identifier[?search(@.uri, 'doi.org')].uri").first
+
+        URI(doi_id).path.delete_prefix("/") if doi_id.present?
+      end
+
+      # The DOI as a URL, if there is one. Any valid DOI should resolve via doi.org.
+      # @return [String, nil]
+      # @example
+      #   record.doi_url #=> "https://doi.org/10.25740/ppax-bf07"
+      def doi_url
+        URI.join("https://doi.org", doi).to_s if doi.present?
+      end
+
+      # The HRID of the item in FOLIO, if defined.
+      # @note This doesn't imply the object is available in Searchworks at this ID.
+      # @return [String, nil]
+      # @example
+      #   record.folio_hrid #=> "a12845814"
+      def folio_hrid
+        path("$.identification.catalogLinks[?(@.catalog == 'folio')].catalogRecordId").first
+      end
+
+      # The FOLIO HRID if defined, otherwise the bare DRUID.
+      # @note This doesn't imply the object is available in Searchworks at this ID.
+      # @see folio_hrid
+      # @see bare_druid
+      # @return [String]
+      def searchworks_id
+        folio_hrid || bare_druid
+      end
+    end
+  end
+end

data/lib/cocina_display/concerns/titles.rb

@@ -0,0 +1,64 @@
+require_relative "../title_builder"
+
+module CocinaDisplay
+  module Concerns
+    # Methods for finding and formatting titles.
+    module Titles
+      # The main title for the object, without subtitle, part name, etc.
+      # If there are multiple titles, uses the first.
+      # @see CocinaDisplay::TitleBuilder#main_title
+      # @note This corresponds to the "short title" in MODS XML, or MARC 245$a only.
+      # @return [String]
+      def main_title
+        CocinaDisplay::TitleBuilder.main_title(cocina_titles).first
+      end
+
+      # The full title for the object, including subtitle, part name, etc.
+      # If there are multiple titles, uses the first.
+      # @see CocinaDisplay::TitleBuilder#full_title
+      # @note This corresponds to the entire MARC 245 field.
+      # @return [String]
+      def full_title
+        CocinaDisplay::TitleBuilder.full_title(cocina_titles, catalog_links: catalog_links).first
+      end
+
+      # The full title, joined together with additional punctuation.
+      # If there are multiple titles, uses the first.
+      # @see CocinaDisplay::TitleBuilder#build
+      # @return [String]
+      def display_title
+        CocinaDisplay::TitleBuilder.build(cocina_titles, catalog_links: catalog_links)
+      end
+
+      # Any additional titles for the object excluding the main title.
+      # @return [Array<String>]
+      # @see CocinaDisplay::TitleBuilder#additional_titles
+      def additional_titles
+        CocinaDisplay::TitleBuilder.additional_titles(cocina_titles)
+      end
+
+      # A string value for sorting by title that sorts missing values last.
+      # Ignores punctuation, leading/trailing spaces, and non-sorting characters.
+      # @see CocinaDisplay::TitleBuilder#sort_title
+      # @return [String]
+      def sort_title
+        CocinaDisplay::TitleBuilder.sort_title(cocina_titles, catalog_links: catalog_links).first || "\u{10FFFF}"
+      end
+
+      private
+
+      # The titles from the Cocina document, as an array of hashes.
+      # @return [Array<Hash>]
+      def cocina_titles
+        @cocina_titles ||= Array(cocina_doc.dig("description", "title"))
+      end
+
+      # The catalog links from the Cocina document, as an array of hashes.
+      # These link to FOLIO and can include part labels used to construct titles.
+      # @return [Array<Hash>]
+      def catalog_links
+        @catalog_links ||= Array(cocina_doc.dig("identification", "catalogLinks"))
+      end
+    end
+  end
+end

data/lib/cocina_display/contributor.rb

@@ -0,0 +1,179 @@
+# frozen_string_literal: true
+
+require "active_support"
+require "active_support/core_ext/object/blank"
+require "active_support/core_ext/array/conversions"
+
+require_relative "utils"
+
+module CocinaDisplay
+  # A contributor to a work, such as an author or publisher.
+  class Contributor
+    attr_reader :cocina
+
+    # Initialize a Contributor object with Cocina structured data.
+    # @param cocina [Hash] The Cocina structured data for the contributor.
+    def initialize(cocina)
+      @cocina = cocina
+    end
+
+    # String representation of the contributor, including name and role.
+    # Used for debugging and logging.
+    # @return [String]
+    def to_s
+      Utils.compact_and_join([display_name, display_role], delimiter: ": ")
+    end
+
+    # Is this contributor a human?
+    # @return [Boolean]
+    def person?
+      cocina["type"] == "person"
+    end
+
+    # Is this contributor an organization?
+    # @return [Boolean]
+    def organization?
+      cocina["type"] == "organization"
+    end
+
+    # Is this contributor a conference?
+    # @return [Boolean]
+    def conference?
+      cocina["type"] == "conference"
+    end
+
+    # Is this contributor marked as primary?
+    # @return [Boolean]
+    def primary?
+      cocina["status"] == "primary"
+    end
+
+    # Does this contributor have a role that indicates they are an author?
+    # @return [Boolean]
+    def author?
+      roles.any? { |role| role["value"] =~ /(author|creator)/i }
+    end
+
+    # Does this contributor have any roles defined?
+    # @return [Boolean]
+    def role?
+      roles.any?
+    end
+
+    # The display name for the contributor as a string.
+    # Uses the first name if multiple names are present.
+    # @param with_date [Boolean] Include life dates, if present
+    # @return [String]
+    def display_name(with_date: false)
+      names.map { |name| name.display_str(with_date: with_date) }.first
+    end
+
+    # A string representation of the contributor's roles, formatted for display.
+    # If there are multiple roles, they are joined with commas.
+    # @return [String]
+    def display_role
+      roles.map { |role| role["value"] }.to_sentence
+    end
+
+    private
+
+    # All names in the Cocina as Name objects.
+    # @return [Array<Name>]
+    def names
+      @names ||= Array(cocina["name"]).map { |name| Name.new(name) }
+    end
+
+    # All roles in the Cocina structured data.
+    # @return [Array<Hash>]
+    def roles
+      Array(cocina["role"])
+    end
+
+    # A name associated with a contributor.
+    class Name
+      attr_reader :cocina
+
+      # Initialize a Name object with Cocina structured data.
+      # @param cocina [Hash] The Cocina structured data for the name.
+      def initialize(cocina)
+        @cocina = cocina
+      end
+
+      # The display string for the name, optionally including life dates.
+      # @param with_date [Boolean] Include life dates, if present
+      # @return [String]
+      # @example no dates
+      #   name.display_name # => "King, Martin Luther, Jr."
+      # @example with dates
+      #   name.display_name(with_date: true) # => "King, Martin Luther, Jr., 1929-1968"
+      def display_str(with_date: false)
+        if dates_str.present? && with_date
+          Utils.compact_and_join([full_name_str, dates_str], delimiter: ", ")
+        else
+          full_name_str
+        end
+      end
+
+      private
+
+      # The full name as a string.
+      # If any names were marked as "display", prefer those.
+      # Otherwise, combine all name components.
+      # @return [String]
+      def full_name_str
+        display_name_str.presence || Utils.compact_and_join(name_components, delimiter: ", ")
+      end
+
+      # Flattened form of any names explicitly marked as "display name".
+      # @return [String]
+      def display_name_str
+        Utils.compact_and_join(Array(name_values["display"]), delimiter: ", ")
+      end
+
+      # List of all name components.
+      # If any of forename, surname, or term of address are present, those are used.
+      # Otherwise, fall back to any names explicitly marked as "name" or untyped.
+      # @return [Array<String>]
+      def name_components
+        [surname_str, forename_ordinal_str, terms_of_address_str].compact_blank.presence || Array(name_values["name"])
+      end
+
+      # Flatten all forenames and ordinals into a single string.
+      # @return [String]
+      def forename_ordinal_str
+        Utils.compact_and_join(Array(name_values["forename"]) + Array(name_values["ordinal"]), delimiter: " ")
+      end
+
+      # Flatten all terms of address into a single string.
+      # @return [String]
+      def terms_of_address_str
+        Utils.compact_and_join(Array(name_values["term of address"]), delimiter: ", ")
+      end
+
+      # Flatten all surnames into a single string.
+      # @return [String]
+      def surname_str
+        Utils.compact_and_join(Array(name_values["surname"]), delimiter: " ")
+      end
+
+      # Flatten all life and activity dates into a single string.
+      # @return [String]
+      def dates_str
+        Utils.compact_and_join(Array(name_values["life dates"]) + Array(name_values["activity dates"]), delimiter: ", ")
+      end
+
+      # A hash mapping destructured name types to their values.
+      # Name values with no type are grouped under "name".
+      # @return [Hash<String, Array<String>>]
+      # @see https://github.com/sul-dlss/cocina-models/blob/main/docs/description_types.md#contributor-name-part-types-for-structured-value
+      # @note Currently we do nothing with "alternative", "inverted full name", "pseudonym", and "transliteration" types.
+      def name_values
+        Utils.flatten_structured_values(cocina).each_with_object({}) do |node, hash|
+          type = node["type"] || "name"
+          hash[type] ||= []
+          hash[type] << node["value"]
+        end.compact_blank
+      end
+    end
+  end
+end

data/lib/cocina_display/imprint.rb

@@ -5,9 +5,10 @@ require "active_support"
 require "active_support/core_ext/enumerable"
 require "active_support/core_ext/object/blank"
 
+require_relative "utils"
+require_relative "marc_country_codes"
 require_relative "dates/date"
 require_relative "dates/date_range"
-require_relative "marc_country_codes"
 
 module CocinaDisplay
   # Wrapper for Cocina events used to generate an imprint statement for display.
@@ -20,23 +21,6 @@ module CocinaDisplay
       cocina_dates.map { |cd| CocinaDisplay::Dates::Date.from_cocina(cd) }.filter(&:parsable?).compact
     end
 
-    # Join non-empty values into a string using provided delimiter.
-    # If values already end in delimiter (ignoring whitespace), join with a space instead.
-    # @param values [Array<String>] The values to compact and join
-    # @param delimiter [String] The delimiter to use for joining, default is space
-    def self.compact_and_join(values, delimiter: " ")
-      compacted_values = values.compact_blank.map(&:strip)
-      return compacted_values.first if compacted_values.one?
-
-      compacted_values.reduce(+"") do |result, value|
-        result << if value.end_with?(delimiter.strip)
-          value + " "
-        else
-          value + delimiter
-        end
-      end.delete_suffix(delimiter)
-    end
-
     attr_reader :cocina, :dates
 
     # Initialize the imprint with Cocina event data.
@@ -49,9 +33,9 @@ module CocinaDisplay
     # The entire imprint statement formatted as a string for display.
     # @return [String]
     def display_str
-      place_pub = self.class.compact_and_join([place_str, publisher_str], delimiter: " : ")
-      edition_place_pub = self.class.compact_and_join([edition_str, place_pub], delimiter: " - ")
-      self.class.compact_and_join([edition_place_pub, date_str], delimiter: ", ")
+      place_pub = Utils.compact_and_join([place_str, publisher_str], delimiter: " : ")
+      edition_place_pub = Utils.compact_and_join([edition_str, place_pub], delimiter: " - ")
+      Utils.compact_and_join([edition_place_pub, date_str], delimiter: ", ")
     end
 
     # Were any of the dates encoded?
@@ -65,25 +49,25 @@ module CocinaDisplay
     # The date portion of the imprint statement, comprising all unique dates.
     # @return [String]
     def date_str
-      self.class.compact_and_join(unique_dates_for_display.map(&:qualified_value))
+      Utils.compact_and_join(unique_dates_for_display.map(&:qualified_value))
     end
 
     # The editions portion of the imprint statement, combining all edition notes.
     # @return [String]
     def edition_str
-      self.class.compact_and_join(Janeway.enum_for("$.note[?@.type == 'edition'].value", cocina))
+      Utils.compact_and_join(Janeway.enum_for("$.note[?@.type == 'edition'].value", cocina))
     end
 
     # The place of publication, combining all location values.
     # @return [String]
     def place_str
-      self.class.compact_and_join(locations_for_display, delimiter: " : ")
+      Utils.compact_and_join(locations_for_display, delimiter: " : ")
     end
 
     # The publisher information, combining all name values for publishers.
     # @return [String]
     def publisher_str
-      self.class.compact_and_join(Janeway.enum_for("$.contributor[?@.role[?@.value == 'publisher']].name[*].value", cocina), delimiter: " : ")
+      Utils.compact_and_join(Janeway.enum_for("$.contributor[?@.role[?@.value == 'publisher']].name[*].value", cocina), delimiter: " : ")
     end
 
     # Get the place name for a location, decoding from MARC if necessary.

data/lib/cocina_display/title_builder.rb

@@ -46,6 +46,16 @@ module CocinaDisplay
       [new(strategy: :all, add_punctuation: false).build(titles)].flatten - full_title(titles)
     end
 
+    # Like the full title, but with any non-sorting characters and punctuation removed.
+    # @param titles [Array<Hash>] The titles to consider.
+    # @param catalog_links [Array<Hash>] The folio catalog links to check for digital serials part labels.
+    # @return [Array<String>] The sort title value(s) for Solr - array due to possible parallelValue
+    def self.sort_title(titles, catalog_links: [])
+      part_label = catalog_links.find { |link| link["catalog"] == "folio" }&.fetch("partLabel", nil)
+      [new(strategy: :first, add_punctuation: false, only_one_parallel_value: false, part_label: part_label, sortable: true).build(titles)]
+        .flatten.compact.map { |title| title.gsub(/[[:punct:]]*/, "").strip }
+    end
+
     # @param strategy [Symbol] ":first" selects a single title value based on precedence of
     # primary, untyped, first occurrence. ":all" returns an array containing all the values.
     # @param add_punctuation [boolean] whether the title should be formatted with punctuation (think of a structured
@@ -54,11 +64,13 @@ module CocinaDisplay
     # of primary, untyped, first occurrence.  When false, return an array containing all the parallel values.
     # Why? Think of e.g. title displayed in blacklight search results vs boosting values for ranking of search results
     # @param part_label [String] the partLabel to add for digital serials display
-    def initialize(strategy:, add_punctuation:, only_one_parallel_value: true, part_label: nil)
+    # @param sortable [boolean] whether the title is intended for sorting, and should have non-sorting parts removed
+    def initialize(strategy:, add_punctuation:, only_one_parallel_value: true, part_label: nil, sortable: false)
       @strategy = strategy
       @add_punctuation = add_punctuation
       @only_one_parallel_value = only_one_parallel_value
       @part_label = part_label
+      @sortable = sortable
     end
 
     # @param [Array<Hash>] cocina_titles the titles to consider
@@ -161,6 +173,10 @@ module CocinaDisplay
       @only_one_parallel_value
     end
 
+    def sortable?
+      @sortable
+    end
+
     # @return [Hash, nil] title that has status=primary
     def primary_title(cocina_titles)
       primary_title = cocina_titles.find { |title| title["status"] == "primary" }
@@ -221,7 +237,7 @@ module CocinaDisplay
     # rubocop:disable Metrics/CyclomaticComplexity
     # rubocop:disable Metrics/MethodLength
     # rubocop:disable Metrics/PerceivedComplexity
-    def rebuild_structured_value(cocina_title)
+    def rebuild_structured_value(cocina_title, sortable: false)
       result = ""
       part_name_number = ""
       cocina_title["structuredValue"].each do |structured_value| # rubocop:disable Metrics/BlockLength
@@ -235,8 +251,10 @@ module CocinaDisplay
         # additional types ignored here, e.g. name, uniform ...
         case structured_value["type"]&.downcase
         when "nonsorting characters"
-          padding = non_sorting_padding(cocina_title, value)
-          result = add_non_sorting_value(result, value, padding)
+          unless sortable?
+            padding = non_sorting_padding(cocina_title, value)
+            result = add_non_sorting_value(result, value, padding)
+          end
         when "part name", "part number"
           # even if there is a partLabel, use any existing structuredValue
           # part name/number that remains for non-digital serials purposes
@@ -286,7 +304,7 @@ module CocinaDisplay
     # rubocop:disable Metrics/PerceivedComplexity
     # rubocop:disable Metrics/AbcSize
     # rubocop:disable Metrics/CyclomaticComplexity
-    def main_title_from_structured_values(cocina_title)
+    def main_title_from_structured_values(cocina_title, sortable: false)
       result = ""
       # combine pieces of the cocina structuredValue into a single title
       cocina_title["structuredValue"].each do |structured_value|
@@ -299,8 +317,10 @@ module CocinaDisplay
 
         case structured_value["type"]&.downcase
         when "nonsorting characters"
-          padding = non_sorting_padding(cocina_title, value)
-          result = add_non_sorting_value(result, value, padding)
+          unless sortable?
+            padding = non_sorting_padding(cocina_title, value)
+            result = add_non_sorting_value(result, value, padding)
+          end
         when "main title", "title"
           result = if ["'", "-"].include?(result.last)
             [result, value].join

data/lib/cocina_display/utils.rb

@@ -0,0 +1,33 @@
+module CocinaDisplay
+  # Helper methods for string formatting, etc.
+  module Utils
+    # Join non-empty values into a string using provided delimiter.
+    # If values already end in delimiter (ignoring whitespace), join with a space instead.
+    # @param values [Array<String>] The values to compact and join
+    # @param delimiter [String] The delimiter to use for joining, default is space
+    # @return [String] The compacted and joined string
+    def self.compact_and_join(values, delimiter: " ")
+      compacted_values = values.compact_blank.map(&:strip)
+      return compacted_values.first if compacted_values.one?
+
+      compacted_values.reduce(+"") do |result, value|
+        result << if value.end_with?(delimiter.strip)
+          value + " "
+        else
+          value + delimiter
+        end
+      end.delete_suffix(delimiter)
+    end
+
+    # Recursively flatten structured values in Cocina metadata.
+    # Returns a list of hashes representing the "leaf" nodes with values.
+    # @return [Array<Hash>] List of node hashes with "value" present
+    def self.flatten_structured_values(cocina, output = [])
+      return [cocina] if cocina["value"].present?
+      return cocina.flat_map { |node| flatten_structured_values(node, output) } if cocina.is_a?(Array)
+      return output unless (structured_values = Array(cocina["structuredValue"])).present?
+
+      structured_values.flat_map { |node| flatten_structured_values(node, output) }
+    end
+  end
+end

data/lib/cocina_display/version.rb

@@ -2,5 +2,5 @@
 
 # :nodoc:
 module CocinaDisplay
-  VERSION = "0.3.0" # :nodoc:
+  VERSION = "0.4.0" # :nodoc:
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cocina_display
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Nick Budak
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-07-08 00:00:00.000000000 Z
+date: 2025-07-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: janeway-jsonpath
@@ -176,12 +176,17 @@ files:
 - Rakefile
 - lib/cocina_display.rb
 - lib/cocina_display/cocina_record.rb
+- lib/cocina_display/concerns/contributors.rb
 - lib/cocina_display/concerns/events.rb
+- lib/cocina_display/concerns/identifiers.rb
+- lib/cocina_display/concerns/titles.rb
+- lib/cocina_display/contributor.rb
 - lib/cocina_display/dates/date.rb
 - lib/cocina_display/dates/date_range.rb
 - lib/cocina_display/imprint.rb
 - lib/cocina_display/marc_country_codes.rb
 - lib/cocina_display/title_builder.rb
+- lib/cocina_display/utils.rb
 - lib/cocina_display/version.rb
 - sig/cocina_display.rbs
 homepage: https://sul-dlss.github.io/cocina_display/