cocina-models 0.119.0 → 0.120.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 95fdb985d82245efee3898558df726439ee7d27e7fa45bd47815b44d52f58679
-  data.tar.gz: 0a7644f423957828280316d0c5709847f260919e1ceb384c130e8196f4d5eb6a
+  metadata.gz: 36dff333c23753eed79b03fd9f4442339d677ba28baaf396408049bedd4ffc69
+  data.tar.gz: 3235a1280a037df4570e19de4f98f86577f6e048c7bb5b00d3c7f6a69dc2b377
 SHA512:
-  metadata.gz: ce4a6079617e05fd8d5b1547d16e983e06f0f53914339f9f19dcb4a870d52c1c565844bb39b0ed5decffe2c68f2a4fc4f2b385b9d8dd4796700f2c1f9aed5c7b
-  data.tar.gz: eb72b867dcab3ad0ee2e63d3b68276c17fb831365f4c6a785a95fa8250998b663c6bcca2d50d4ffc6786044a17df7321847c069595587a9ae3ac96120f093020
+  metadata.gz: 79466fddfa3fe42db002704a4d8f1e62e282e85dfe593aa7a6e58aea0449a247304d7b96596b15809f5a7f5ced5d0308160afee3efc95f3ec9051354e02e8eb2
+  data.tar.gz: b22313bbb8cea20829173cbf8569b5402472a7e01354a5e2790290771ecbb59e20eca361a94307b15fd2674f04ecfe62d7b57304eda8fb514bc0af7b35d9e832

data/.circleci/config.yml

@@ -1,6 +1,6 @@
 version: 2.1
 orbs:
-  ruby-rails: sul-dlss/ruby-rails@4.8.0
+  ruby-rails: sul-dlss/ruby-rails@4.10.0
 workflows:
   build:
     jobs:

data/.rubocop.yml

@@ -126,6 +126,12 @@ RSpec/BeEq: # new in 2.9.0
 RSpec/BeNil: # new in 2.9.0
   Enabled: true
 
+RSpec/DiscardedMatcher: # new in 3.10
+  Enabled: true
+
+RSpec/MatchWithSimpleRegex: # new in 3.10
+  Enabled: true
+
 RSpec/MultipleExpectations:
   Enabled: false
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    cocina-models (0.119.0)
+    cocina-models (0.120.0)
       activesupport
       deprecation
       dry-struct (~> 1.0)
@@ -9,8 +9,7 @@ PATH
       edtf
       equivalent-xml
       i18n
-      json_schemer (~> 2.0)
-      jsonpath
+      jsonschema_rs
       nokogiri
       super_diff
       thor
@@ -74,7 +73,6 @@ GEM
     equivalent-xml (0.6.0)
       nokogiri (>= 1.4.3)
     erb (6.0.4)
-    hana (1.3.7)
     i18n (1.14.8)
       concurrent-ruby (~> 1.0)
     ice_nine (0.11.2)
@@ -84,21 +82,17 @@ GEM
       prism (>= 1.3.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
-    json (2.19.7)
-    json_schemer (2.5.0)
-      bigdecimal
-      hana (~> 1.3)
-      regexp_parser (~> 2.0)
-      simpleidn (~> 0.2)
-    jsonpath (1.1.5)
-      multi_json
+    json (2.19.8)
+    jsonschema_rs (0.46.5-arm64-darwin)
+      bigdecimal (>= 3.1, < 5)
+    jsonschema_rs (0.46.5-x86_64-linux)
+      bigdecimal (>= 3.1, < 5)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
     logger (1.7.0)
     minitest (6.0.6)
       drb (~> 2.0)
       prism (~> 1.5)
-    multi_json (1.21.1)
     nokogiri (1.19.3-arm64-darwin)
       racc (~> 1.4)
     nokogiri (1.19.3-x86_64-linux-gnu)
@@ -114,7 +108,7 @@ GEM
       prettyprint
     prettyprint (0.2.0)
     prism (1.9.0)
-    psych (5.3.1)
+    psych (5.4.0)
       date
       stringio
     racc (1.8.1)
@@ -159,9 +153,10 @@ GEM
     rubocop-rake (0.7.1)
       lint_roller (~> 1.1)
       rubocop (>= 1.72.1)
-    rubocop-rspec (3.9.0)
+    rubocop-rspec (3.10.2)
       lint_roller (~> 1.1)
-      rubocop (~> 1.81)
+      regexp_parser (>= 2.0)
+      rubocop (~> 1.86, >= 1.86.2)
     ruby-progressbar (1.13.0)
     securerandom (0.4.1)
     simplecov (0.22.0)
@@ -170,7 +165,6 @@ GEM
       simplecov_json_formatter (~> 0.1)
     simplecov-html (0.13.2)
     simplecov_json_formatter (0.1.4)
-    simpleidn (0.2.3)
     stringio (3.2.0)
     super_diff (0.19.0)
       attr_extras (>= 6.2.4, < 8)
@@ -209,8 +203,8 @@ CHECKSUMS
   attr_extras (7.1.0) sha256=d96fc9a9dd5d85ba2d37762440a816f840093959ae26bb90da994c2d9f1fc827
   base64 (0.3.0) sha256=27337aeabad6ffae05c265c450490628ef3ebd4b67be58257393227588f5a97b
   bigdecimal (4.1.2) sha256=53d217666027eab4280346fba98e7d5b66baaae1b9c3c1c0ffe89d48188a3fbd
-  bundler (4.0.12) sha256=7f8b757d28dfb636e7b24fba2344ac6dd13b5b24f4b46d62573d483f211825ac
-  cocina-models (0.119.0)
+  bundler (4.0.13) sha256=19f08be7f27022cf0b89f27da0b044ae075e8270a9ef44ad248a932614e1ca3b
+  cocina-models (0.120.0)
   concurrent-ruby (1.3.6) sha256=6b56837e1e7e5292f9864f34b69c5a2cbc75c0cf5338f1ce9903d10fa762d5ab
   connection_pool (3.0.2) sha256=33fff5ba71a12d2aa26cb72b1db8bba2a1a01823559fb01d29eb74c286e62e0a
   date (3.5.1) sha256=750d06384d7b9c15d562c76291407d89e368dda4d4fff957eb94962d325a0dc0
@@ -227,19 +221,17 @@ CHECKSUMS
   edtf (3.2.0) sha256=a15a0ee274e49c8047a3ebb5d61d793ba44f7f8ffbf0595392c467e3ea8d2447
   equivalent-xml (0.6.0) sha256=8919761efa848ad0846369ff8be1f646b17e5061698c4867b09829000cc3f487
   erb (6.0.4) sha256=38e3803694be357fe2bfe312487c74beaf9fb4e5beb3e22498952fe1645b95d9
-  hana (1.3.7) sha256=5425db42d651fea08859811c29d20446f16af196308162894db208cac5ce9b0d
   i18n (1.14.8) sha256=285778639134865c5e0f6269e0b818256017e8cde89993fdfcbfb64d088824a5
   ice_nine (0.11.2) sha256=5d506a7d2723d5592dc121b9928e4931742730131f22a1a37649df1c1e2e63db
   io-console (0.8.2) sha256=d6e3ae7a7cc7574f4b8893b4fca2162e57a825b223a177b7afa236c5ef9814cc
   irb (1.18.0) sha256=de9454a0703a54704b9811a5ef31a60c86949fbf4013fcf244fabc7c775248e3
-  json (2.19.7) sha256=fe432c8639f6efff69f9d73b518a3705d9581ab93156f981ea72806e1e5bcc3e
-  json_schemer (2.5.0) sha256=2f01fb4cce721a4e08dd068fc2030cffd0702a7f333f1ea2be6e8991f00ae396
-  jsonpath (1.1.5) sha256=29f70467193a2dc93ab864ec3d3326d54267961acc623f487340eb9c34931dbe
+  json (2.19.8) sha256=6354310fd76ef69b87d5bd1f38b40d730613baf90b6803d2d0a48f618d32dfaa
+  jsonschema_rs (0.46.5-arm64-darwin) sha256=e80414ed67f0956d3e06474a2fa076fc4a7b722f00e5d7142b70289c016ac6f1
+  jsonschema_rs (0.46.5-x86_64-linux) sha256=345c65ec7a5abf8879b9c9356752f0fdf4c9926f6480458fc32803a871b5cbb3
   language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
   lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
   logger (1.7.0) sha256=196edec7cc44b66cfb40f9755ce11b392f21f7967696af15d274dde7edff0203
   minitest (6.0.6) sha256=153ea36d1d987a62942382b61075745042a2b3123b1cd48f4c3675af9cc7d6f1
-  multi_json (1.21.1) sha256=e6126a31808e3b4d19f483c775ceac34df190dffa62adfb63a165ee14ba68080
   nokogiri (1.19.3-arm64-darwin) sha256=71b9bd424b1b7abc18b05052a1a3cfd3627abdca62be280854cc411791357e42
   nokogiri (1.19.3-x86_64-linux-gnu) sha256=2f5078620fe12e83669b5b17311b32532a8153d02eee7ad06948b926d6080976
   optimist (3.2.1) sha256=8cf8a0fd69f3aa24ab48885d3a666717c27bc3d9edd6e976e18b9d771e72e34e
@@ -249,7 +241,7 @@ CHECKSUMS
   pp (0.6.3) sha256=2951d514450b93ccfeb1df7d021cae0da16e0a7f95ee1e2273719669d0ab9df6
   prettyprint (0.2.0) sha256=2bc9e15581a94742064a3cc8b0fb9d45aae3d03a1baa6ef80922627a0766f193
   prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85
-  psych (5.3.1) sha256=eb7a57cef10c9d70173ff74e739d843ac3b2c019a003de48447b2963d81b1974
+  psych (5.4.0) sha256=14f72d69a611af663d7d70e4a7b67d9eb1f3ae9f8d916b478961d5a0075ba5b7
   racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f
   rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
   rake (13.4.2) sha256=cb825b2bd5f1f8e91ca37bddb4b9aaf345551b4731da62949be002fa89283701
@@ -265,13 +257,12 @@ CHECKSUMS
   rubocop (1.87.0) sha256=b9d9ddf55116a513f8ef2c7ae660662d8b49301f118d3f0df61865b33a5c188d
   rubocop-ast (1.49.1) sha256=4412f3ee70f6fe4546cc489548e0f6fcf76cafcfa80fa03af67098ffed755035
   rubocop-rake (0.7.1) sha256=3797f2b6810c3e9df7376c26d5f44f3475eda59eb1adc38e6f62ecf027cbae4d
-  rubocop-rspec (3.9.0) sha256=8fa70a3619408237d789aeecfb9beef40576acc855173e60939d63332fdb55e2
+  rubocop-rspec (3.10.2) sha256=0b3e2ecc592cd10ecbf0095bb58d1e357905276e069643523cc19eb7495f65e2
   ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
   securerandom (0.4.1) sha256=cc5193d414a4341b6e225f0cb4446aceca8e50d5e1888743fac16987638ea0b1
   simplecov (0.22.0) sha256=fe2622c7834ff23b98066bb0a854284b2729a569ac659f82621fc22ef36213a5
   simplecov-html (0.13.2) sha256=bd0b8e54e7c2d7685927e8d6286466359b6f16b18cb0df47b508e8d73c777246
   simplecov_json_formatter (0.1.4) sha256=529418fbe8de1713ac2b2d612aa3daa56d316975d307244399fa4838c601b428
-  simpleidn (0.2.3) sha256=08ce96f03fa1605286be22651ba0fc9c0b2d6272c9b27a260bc88be05b0d2c29
   stringio (3.2.0) sha256=c37cb2e58b4ffbd33fe5cd948c05934af997b36e0b6ca6fdf43afa234cf222e1
   super_diff (0.19.0) sha256=c35fc1c0daa223d67b203fe3fb49a6cfd67850a53920319565c3c654e03ec902
   thor (1.5.0) sha256=e3a9e55fe857e44859ce104a84675ab6e8cd59c650a49106a05f55f136425e73
@@ -283,4 +274,4 @@ CHECKSUMS
   zeitwerk (2.8.2) sha256=7212a61311083c604184b1ea2574b9aa05cd14f855a0841c06985cabe9181d12
 
 BUNDLED WITH
-  4.0.12
+  4.0.13

data/bin/validate-data

@@ -191,6 +191,8 @@ def distribute_work(filename, workers, batch_size, total_lines) # rubocop:disabl
 
       # Update progress bar
       progressbar.increment
+
+      break if line_number >= total_lines
     end
   end
 

data/bin/validate-schema

@@ -5,4 +5,9 @@ require 'bundler/setup'
 require 'cocina/models'
 
 filepath = ARGV[0]
-exit(1) unless JSONSchemer.valid_schema?(Pathname.new(filepath))
+begin
+  JSONSchema.validator_for(JSON.parse(File.read(filepath)))
+rescue StandardError => e
+  warn e.message
+  exit(1)
+end

data/cocina-models.gemspec

@@ -31,8 +31,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'edtf' # used for date/time validation
   spec.add_dependency 'equivalent-xml' # for diffing MODS
   spec.add_dependency 'i18n' # for validating BCP 47 language tags, according to RFC 4646
-  spec.add_dependency 'jsonpath' # used for date/time validation
-  spec.add_dependency 'json_schemer', '~> 2.0'
+  spec.add_dependency 'jsonschema_rs'
   spec.add_dependency 'nokogiri'
   spec.add_dependency 'super_diff'
   spec.add_dependency 'thor'

data/lib/cocina/models/mapping/from_mods/event.rb

@@ -435,7 +435,7 @@ module Cocina
               new_node = node.deep_dup
               new_node.remove_attribute('encoding') if common_attribs[:encoding].present? || node[:encoding]&.empty?
               new_node.remove_attribute('qualifier') if common_attribs[:qualifier].present? || node[:qualifier]&.empty?
-              build_date(new_node)
+              build_date(new_node, encoding: common_attribs.dig(:encoding, :code))
             end
             { structuredValue: dates }.merge(common_attribs).compact
           end
@@ -462,9 +462,11 @@ module Cocina
             attribs.compact
           end
 
-          def build_date(date_node)
+          def build_date(date_node, encoding: nil)
+            effective_encoding = date_node['encoding'] || encoding
             {}.tap do |date|
-              date[:value] = clean_date(date_node.text) if date_node.text.present?
+              raw_value = clean_date(date_node.text)
+              date[:value] = effective_encoding == 'edtf' ? pad_edtf_year(raw_value) : raw_value if date_node.text.present?
               date[:encoding] = { code: date_node['encoding'] } if date_node['encoding']
               date[:status] = 'primary' if date_node['keyDate']
               date[:note] = build_date_note(date_node)
@@ -489,6 +491,13 @@ module Cocina
             date.delete_suffix('.')
           end
 
+          # Pads a 1-3 digit year to 4 digits, handling modifiers like ~,-.
+          def pad_edtf_year(value)
+            value.sub(%r{\A(-?)(\d{1,3})(?=[~?%/-]|\z)}) do
+              "#{::Regexp.last_match(1)}#{::Regexp.last_match(2).rjust(4, '0')}"
+            end
+          end
+
           # NOTE: Do any eventType/displayLabel transformations before determining role (i.e. with LEGACY_EVENT_TYPES_2_TYPE)
           def role_for(event)
             case event[:type]

data/lib/cocina/models/related_resource.rb

@@ -14,7 +14,7 @@ module Cocina
       # The preferred display label to use for the related resource in access systems.
       attribute? :displayLabel, Types::Strict::String.optional
       # Titles of the related resource.
-      attribute :title, Types::Strict::Array.of(DescriptiveValue).default([].freeze)
+      attribute :title, Types::Strict::Array.of(Title).default([].freeze)
       # Agents contributing in some way to the creation and history of the related resource.
       attribute :contributor, Types::Strict::Array.of(Contributor).default([].freeze)
       # Events in the history of the related resource.

data/lib/cocina/models/validators/base_description_visitor_validator.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    module Validators
+      # Super class for description validators that use a visitor pattern.
+      class BaseDescriptionVisitorValidator
+        def visit_hash(hash:, path:); end
+
+        def visit_array(array:, path:); end
+
+        def visit_obj(obj:, path:); end
+
+        # @raise [ValidationError] if validation fails
+        def validate!; end
+
+        def path_to_s(path)
+          # This matches the format used by descriptive spreadsheets
+          path_str = ''
+          path.each_with_index do |part, index|
+            if part.is_a?(Integer)
+              path_str += (part + 1).to_s
+            else
+              path_str += '.' if index.positive?
+              path_str += part.to_s
+            end
+          end
+          path_str
+        end
+      end
+    end
+  end
+end

data/lib/cocina/models/validators/base_structural_visitor_validator.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    module Validators
+      # Super class for structural validators that use a visitor pattern.
+      class BaseStructuralVisitorValidator
+        def initialize(attributes)
+          @attributes = attributes
+        end
+
+        def visit_file(file_hash:); end
+
+        # @raise [ValidationError] if validation fails
+        def validate!; end
+
+        private
+
+        attr_reader :attributes
+      end
+    end
+  end
+end

data/lib/cocina/models/validators/composite_description_validator.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    module Validators
+      # Composite validator for description that uses a visitor pattern to validate in a single pass.
+      class CompositeDescriptionValidator
+        VALIDATORS = [
+          DescriptionTypesVisitorValidator,
+          DescriptionValuesVisitorValidator,
+          DescriptionDateTimeVisitorValidator
+        ].freeze
+
+        def self.validate(clazz, attributes)
+          new(clazz, attributes).validate
+        end
+
+        def initialize(clazz, attributes, validators: VALIDATORS)
+          @clazz = clazz
+          @attributes = attributes
+          @validators = validators.map(&:new)
+        end
+
+        def validate
+          return unless meets_preconditions?
+
+          validate_obj(obj: attributes, path: [])
+
+          validators.each(&:validate!)
+        end
+
+        private
+
+        attr_reader :clazz, :attributes, :validators
+
+        def meets_preconditions?
+          [Cocina::Models::Description, Cocina::Models::RequestDescription].include?(clazz)
+        end
+
+        def validate_hash(hash:, path:)
+          validators.each { |validator| validator.visit_hash(hash:, path:) }
+          hash.each do |key, obj|
+            validate_obj(obj:, path: path + [key])
+          end
+        end
+
+        def validate_array(array:, path:)
+          validators.each { |validator| validator.visit_array(array:, path:) }
+          array.each_with_index do |obj, index|
+            validate_obj(obj:, path: path + [index])
+          end
+        end
+
+        def validate_obj(obj:, path:)
+          validators.each { |validator| validator.visit_obj(obj:, path:) }
+          validate_hash(hash: obj, path: path) if obj.is_a?(Hash)
+          validate_array(array: obj, path: path) if obj.is_a?(Array)
+        end
+      end
+    end
+  end
+end

data/lib/cocina/models/validators/composite_structural_validator.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    module Validators
+      # Composite validator for structural metadata that uses a visitor pattern to validate files in a single pass.
+      class CompositeStructuralValidator
+        VALIDATORS = [
+          DarkVisitorValidator,
+          LanguageTagVisitorValidator,
+          ReservedFilenameVisitorValidator
+        ].freeze
+
+        def self.validate(clazz, attributes)
+          new(clazz, attributes).validate
+        end
+
+        def initialize(clazz, attributes, validators: VALIDATORS)
+          @clazz = clazz
+          @attributes = attributes
+          @validators = validators.map { |v| v.new(attributes) }
+        end
+
+        def validate
+          return unless meets_preconditions?
+
+          Array(attributes.dig(:structural, :contains)).each do |fileset_hash|
+            Array(fileset_hash.dig(:structural, :contains)).each do |file_hash|
+              validators.each { |validator| validator.visit_file(file_hash:) }
+            end
+          end
+
+          validators.each(&:validate!)
+        end
+
+        private
+
+        attr_reader :clazz, :attributes, :validators
+
+        def meets_preconditions?
+          clazz::TYPES.intersect?(DRO::TYPES)
+        rescue NameError
+          false
+        end
+      end
+    end
+  end
+end

data/lib/cocina/models/validators/dark_visitor_validator.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    module Validators
+      # Validates that shelve and publish file attributes are set to false for dark DRO objects.
+      class DarkVisitorValidator < BaseStructuralVisitorValidator
+        def visit_file(file_hash:)
+          return unless dark_object?
+
+          invalid_files << file_hash if invalid?(file_hash)
+        end
+
+        def validate!
+          return if invalid_files.empty?
+
+          filenames = invalid_files.map { |file| file[:filename] || file[:label] }
+          raise ValidationError, 'Not all files have dark access and/or are unshelved ' \
+                                 "when object access is dark: #{filenames}"
+        end
+
+        private
+
+        def invalid_files
+          @invalid_files ||= []
+        end
+
+        def dark_object?
+          # Checking for nil to account for default being dark.
+          @dark_object ||= ['dark', nil].include?(attributes.dig(:access, :view))
+        end
+
+        def invalid?(file)
+          # Ignore if a WARC
+          return false if file[:hasMimeType] == 'application/warc'
+
+          return true if file.dig(:administrative, :shelve)
+          # Checking for nil to account for default being dark.
+          return true if ['dark', nil].exclude?(file.dig(:access, :view))
+
+          false
+        end
+      end
+    end
+  end
+end

data/lib/cocina/models/validators/description_date_time_visitor_validator.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+require 'edtf'
+
+module Cocina
+  module Models
+    module Validators
+      # Validates that dates of known types are type-valid using the visitor pattern.
+      class DescriptionDateTimeVisitorValidator < BaseDescriptionVisitorValidator
+        VALIDATABLE_TYPES = %w[edtf iso8601 w3cdtf].freeze
+
+        def visit_hash(hash:, path:) # rubocop:disable Metrics/CyclomaticComplexity
+          # Only dates nested under a `date` key are subject to validation.
+          # For example, event.date is in scope but event.note is not.
+          return unless in_date_path?(path)
+
+          # A hash with a validatable encoding.code "owns" the encoding for its
+          # entire subtree.  For example, the outer hash below owns iso8601 for
+          # both structuredValue children even though those children carry no
+          # encoding themselves:
+          #
+          #   date: [{
+          #     structuredValue: [
+          #       { value: '1996', type: 'start' },
+          #       { value: '1998', type: 'end' }
+          #     ],
+          #     encoding: { code: 'iso8601' }   # ← registered at path [:date, 0]
+          #   }]
+          #
+          # We record the path before visiting children because
+          # CompositeDescriptionValidator calls visit_hash on a parent before
+          # recursing into its children, so the encoding is always registered
+          # before any child value hashes are visited.
+          code = hash.dig(:encoding, :code)
+          encoding_paths[path.dup] = code if code && VALIDATABLE_TYPES.include?(code)
+
+          value = hash[:value]
+          return unless value.is_a?(String)
+
+          # Resolve which encoding governs this value by finding the longest
+          # registered encoding path that is a prefix of the current path.
+          # Longest-prefix wins so that a more-specific inner encoding overrides
+          # a less-specific outer one.  For example, given:
+          #
+          #   date: [{
+          #     parallelValue: [
+          #       { value: '1996', encoding: { code: 'edtf' } },  # path [:date,0,:parallelValue,0]
+          #       { value: '一九九六' }                              # path [:date,0,:parallelValue,1]
+          #     ],
+          #     encoding: { code: 'iso8601' }                      # path [:date,0]
+          #   }]
+          #
+          # The value '1996' at [:date,0,:parallelValue,0] matches both [:date,0]
+          # (iso8601) and [:date,0,:parallelValue,0] (edtf); the longer prefix wins
+          # and it is validated as edtf.  The value '一九九六' at
+          # [:date,0,:parallelValue,1] only matches [:date,0] (iso8601).
+          encoding_path, code = find_encoding_for(path)
+          return unless code
+
+          invalid_groups[encoding_path] ||= []
+          invalid_groups[encoding_path] << value unless valid_value?(value, code)
+        end
+
+        def validate!
+          return if invalid_groups.empty?
+
+          invalid_dates = invalid_groups.filter_map do |path, values|
+            next if values.empty?
+
+            [*values, encoding_paths[path]]
+          end
+
+          return if invalid_dates.empty?
+
+          raise ValidationError, "Invalid date(s) in description: #{invalid_dates}"
+        end
+
+        private
+
+        def encoding_paths
+          @encoding_paths ||= {}
+        end
+
+        def invalid_groups
+          @invalid_groups ||= {}
+        end
+
+        def in_date_path?(path)
+          path.any? { |part| part.to_s == 'date' }
+        end
+
+        def find_encoding_for(path)
+          encoding_paths
+            .select { |prefix, _| path.first(prefix.length) == prefix }
+            .max_by { |prefix, _| prefix.length }
+        end
+
+        def valid_value?(value, code)
+          send(:"valid_#{code}?", value)
+        end
+
+        def valid_edtf?(value)
+          return false if value == 'XXXX'
+
+          Date.edtf!(value)
+          true
+        rescue StandardError
+          # NOTE: the upstream EDTF implementation in the `edtf` gem does not
+          #       allow a valid pattern that we use (possibly because only level
+          #       0 of the spec was implemented?):
+          #
+          # * Y-20555
+          #
+          # So we catch the false positives from the upstream gem and allow
+          # this pattern to validate
+          /\AY-?\d{5,}\Z/.match?(value)
+        end
+
+        def valid_iso8601?(value)
+          DateTime.iso8601(value)
+          true
+        rescue StandardError
+          false
+        end
+
+        def valid_w3cdtf?(value)
+          W3cdtfValidator.validate(value)
+        end
+      end
+    end
+  end
+end