cocina_display 0.2.0 → 0.4.0

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.2.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.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Nick Budak
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-06-26 00:00:00.000000000 Z
+date: 2025-07-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: janeway-jsonpath
@@ -44,6 +44,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 8.0.2
+- !ruby/object:Gem::Dependency
+  name: edtf
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -162,7 +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/