arclight 0.5.0 → 1.0.0.beta1

data/.rubocop_todo.yml

@@ -1,102 +1,28 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2021-05-17 20:57:22 UTC using RuboCop version 1.15.0.
+# on 2022-10-05 03:27:31 UTC using RuboCop version 1.36.0.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 1
-# Configuration parameters: Include.
-# Include: **/*.gemspec
-Gemspec/RequiredRubyVersion:
-  Exclude:
-    - 'arclight.gemspec'
-
-# Offense count: 2
-# Cop supports --auto-correct.
-# Configuration parameters: EnforcedStyleAlignWith, Severity.
-# SupportedStylesAlignWith: start_of_line, begin
-Layout/BeginEndAlignment:
-  Exclude:
-    - 'app/models/arclight/document_downloads.rb'
-    - 'lib/tasks/index.rake'
-
-# Offense count: 1
-# Cop supports --auto-correct.
-# Configuration parameters: EmptyLineBetweenMethodDefs, EmptyLineBetweenClassDefs, EmptyLineBetweenModuleDefs, AllowAdjacentOneLineDefs, NumberOfEmptyLines.
-Layout/EmptyLineBetweenDefs:
-  Exclude:
-    - 'lib/arclight/exceptions.rb'
-
-# Offense count: 7
-# Cop supports --auto-correct.
-# Configuration parameters: AllowAliasSyntax, AllowedMethods.
-# AllowedMethods: alias_method, public, protected, private
-Layout/EmptyLinesAroundAttributeAccessor:
-  Exclude:
-    - 'app/models/arclight/document_downloads.rb'
-    - 'app/models/arclight/parent.rb'
-    - 'app/models/arclight/parents.rb'
-    - 'app/models/arclight/requests/aeon_web_ead.rb'
-    - 'app/models/arclight/requests/google_form.rb'
-    - 'lib/arclight/digital_object.rb'
-    - 'lib/arclight/hash_absolute_xpath.rb'
-
 # Offense count: 2
-# Cop supports --auto-correct.
-Layout/RescueEnsureAlignment:
-  Exclude:
-    - 'app/models/arclight/document_downloads.rb'
-    - 'lib/tasks/index.rake'
-
-# Offense count: 2
-# Configuration parameters: IgnoredMethods.
-Lint/AmbiguousBlockAssociation:
-  Exclude:
-    - 'lib/arclight/traject/ead2_config.rb'
-
-# Offense count: 1
-# Cop supports --auto-correct.
-Lint/RedundantCopDisableDirective:
-  Exclude:
-    - 'spec/features/search_results_spec.rb'
-
-# Offense count: 1
-# Cop supports --auto-correct.
-Lint/SendWithMixinArgument:
-  Exclude:
-    - 'lib/arclight/engine.rb'
-
-# Offense count: 1
-# Cop supports --auto-correct.
-Lint/UriRegexp:
-  Exclude:
-    - 'lib/tasks/index.rake'
-
-# Offense count: 1
-# Configuration parameters: CheckForMethodsWithNoSideEffects.
-Lint/Void:
-  Exclude:
-    - 'lib/arclight/year_range.rb'
-
-# Offense count: 1
-# Configuration parameters: IgnoredMethods, CountRepeatedAttributes.
+# Configuration parameters: AllowedMethods, AllowedPatterns, IgnoredMethods, CountRepeatedAttributes.
 Metrics/AbcSize:
   Max: 19
 
 # Offense count: 2
-# Configuration parameters: IgnoredMethods.
+# Configuration parameters: AllowedMethods, AllowedPatterns, IgnoredMethods.
 Metrics/CyclomaticComplexity:
   Max: 8
 
 # Offense count: 4
-# Configuration parameters: CountComments, CountAsOne, ExcludedMethods, IgnoredMethods.
+# Configuration parameters: CountComments, CountAsOne, ExcludedMethods, AllowedMethods, AllowedPatterns, IgnoredMethods.
 Metrics/MethodLength:
   Max: 17
 
 # Offense count: 1
-# Configuration parameters: IgnoredMethods.
+# Configuration parameters: AllowedMethods, AllowedPatterns, IgnoredMethods.
 Metrics/PerceivedComplexity:
   Max: 9
 
@@ -108,40 +34,25 @@ Naming/HeredocDelimiterNaming:
     - 'spec/features/autocomplete_spec.rb'
 
 # Offense count: 80
-# Configuration parameters: Prefixes.
+# Configuration parameters: Prefixes, AllowedPatterns.
 # Prefixes: when, with, without
 RSpec/ContextWording:
   Enabled: false
 
 # Offense count: 1
-# Cop supports --auto-correct.
+# This cop supports unsafe autocorrection (--autocorrect-all).
 # Configuration parameters: SkipBlocks, EnforcedStyle.
 # SupportedStyles: described_class, explicit
 RSpec/DescribedClass:
   Exclude:
     - 'spec/presenters/arclight/show_presenter_spec.rb'
 
-# Offense count: 55
-# Cop supports --auto-correct.
-RSpec/EmptyLineAfterExampleGroup:
-  Enabled: false
-
-# Offense count: 10
-# Cop supports --auto-correct.
-RSpec/EmptyLineAfterHook:
-  Exclude:
-    - 'spec/features/collection_page_spec.rb'
-    - 'spec/features/home_page_spec.rb'
-    - 'spec/features/many_component_ead_spec.rb'
-    - 'spec/helpers/arclight_helper_spec.rb'
-    - 'spec/views/repositories/index.html.erb_spec.rb'
-
-# Offense count: 63
+# Offense count: 62
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
   Max: 49
 
-# Offense count: 3
+# Offense count: 2
 RSpec/ExpectInHook:
   Exclude:
     - 'spec/helpers/arclight_helper_spec.rb'
@@ -153,7 +64,7 @@ RSpec/FilePath:
   Exclude:
     - 'spec/lib/arclight/viewers/oembed_spec.rb'
 
-# Offense count: 133
+# Offense count: 132
 RSpec/MultipleExpectations:
   Max: 25
 
@@ -163,11 +74,12 @@ RSpec/MultipleMemoizedHelpers:
   Max: 10
 
 # Offense count: 19
+# Configuration parameters: AllowedGroups.
 RSpec/NestedGroups:
-  Max: 4
+  Max: 5
 
 # Offense count: 7
-# Cop supports --auto-correct.
+# This cop supports unsafe autocorrection (--autocorrect-all).
 # Configuration parameters: Strict, EnforcedStyle, AllowedExplicitMatchers.
 # SupportedStyles: inflected, explicit
 RSpec/PredicateMatcher:
@@ -175,35 +87,19 @@ RSpec/PredicateMatcher:
     - 'spec/helpers/arclight_helper_spec.rb'
     - 'spec/lib/arclight/year_range_spec.rb'
 
-# Offense count: 7
+# Offense count: 3
 RSpec/StubbedMock:
   Exclude:
     - 'spec/helpers/arclight_helper_spec.rb'
     - 'spec/lib/arclight/viewer_spec.rb'
 
-# Offense count: 4
-# Cop supports --auto-correct.
+# Offense count: 2
+# This cop supports unsafe autocorrection (--autocorrect-all).
 # Configuration parameters: NilOrEmpty, NotPresent, UnlessPresent.
 Rails/Blank:
   Exclude:
-    - 'app/controllers/concerns/arclight/ead_format_helpers.rb'
     - 'lib/arclight/repository.rb'
 
-# Offense count: 5
-# Cop supports --auto-correct.
-Rails/ContentTag:
-  Exclude:
-    - 'app/controllers/concerns/arclight/ead_format_helpers.rb'
-    - 'app/controllers/concerns/arclight/field_config_helpers.rb'
-    - 'app/helpers/arclight_helper.rb'
-
-# Offense count: 1
-# Configuration parameters: EnforcedStyle.
-# SupportedStyles: slashes, arguments
-Rails/FilePath:
-  Exclude:
-    - 'app/models/arclight/document_downloads.rb'
-
 # Offense count: 1
 # Configuration parameters: Include.
 # Include: app/helpers/**/*.rb
@@ -211,25 +107,13 @@ Rails/HelperInstanceVariable:
   Exclude:
     - 'app/helpers/arclight_helper.rb'
 
-# Offense count: 1
-# Cop supports --auto-correct.
-Rails/IndexWith:
-  Exclude:
-    - 'app/models/arclight/document_downloads.rb'
-
 # Offense count: 1
 Rails/OutputSafety:
   Exclude:
-    - 'app/controllers/concerns/arclight/field_config_helpers.rb'
-
-# Offense count: 1
-# Cop supports --auto-correct.
-Rails/Presence:
-  Exclude:
-    - 'lib/arclight/digital_object.rb'
+    - 'app/helpers/arclight/field_config_helpers.rb'
 
 # Offense count: 7
-# Cop supports --auto-correct.
+# This cop supports unsafe autocorrection (--autocorrect-all).
 # Configuration parameters: Include.
 # Include: **/Rakefile, **/*.rake
 Rails/RakeEnvironment:
@@ -241,64 +125,3 @@ Rails/RakeEnvironment:
 Security/Open:
   Exclude:
     - 'lib/tasks/index.rake'
-
-# Offense count: 1
-# Cop supports --auto-correct.
-# Configuration parameters: EnforcedStyle, ProceduralMethods, FunctionalMethods, IgnoredMethods, AllowBracesOnProceduralOneLiners, BracesRequiredMethods.
-# SupportedStyles: line_count_based, semantic, braces_for_chaining, always_braces
-# ProceduralMethods: benchmark, bm, bmbm, create, each_with_object, measure, new, realtime, tap, with_object
-# FunctionalMethods: let, let!, subject, watch
-# IgnoredMethods: lambda, proc, it
-Style/BlockDelimiters:
-  Exclude:
-    - 'lib/tasks/index.rake'
-
-# Offense count: 1
-# Cop supports --auto-correct.
-# Configuration parameters: Keywords.
-# Keywords: TODO, FIXME, OPTIMIZE, HACK, REVIEW, NOTE
-Style/CommentAnnotation:
-  Exclude:
-    - 'app/models/concerns/arclight/solr_document.rb'
-
-# Offense count: 1
-# Cop supports --auto-correct.
-Style/CommentedKeyword:
-  Exclude:
-    - 'lib/arclight/year_range.rb'
-
-# Offense count: 1
-# Configuration parameters: AllowedConstants.
-Style/Documentation:
-  Exclude:
-    - 'lib/arclight.rb'
-
-# Offense count: 4
-# Configuration parameters: MaxUnannotatedPlaceholdersAllowed, IgnoredMethods.
-# SupportedStyles: annotated, template, unannotated
-Style/FormatStringToken:
-  EnforcedStyle: template
-
-# Offense count: 1
-# Cop supports --auto-correct.
-Style/HashEachMethods:
-  Exclude:
-    - 'lib/arclight/repository.rb'
-
-# Offense count: 2
-# Cop supports --auto-correct.
-Style/IfUnlessModifier:
-  Exclude:
-    - 'app/models/concerns/arclight/search_behavior.rb'
-
-# Offense count: 1
-# Cop supports --auto-correct.
-Style/RedundantRegexpEscape:
-  Exclude:
-    - 'spec/features/collection_page_spec.rb'
-
-# Offense count: 1
-# Cop supports --auto-correct.
-Style/StringConcatenation:
-  Exclude:
-    - 'spec/lib/arclight/repository_spec.rb'

data/CONTRIBUTING.md

@@ -1,13 +1,13 @@
 ## Contributing
 
-ArcLight is a collaborative open source project where contributions are welcome. This contributing guide is borrowed in part from the [GeoBlacklight Contributing Guide](https://github.com/geoblacklight/geoblacklight/blob/master/CONTRIBUTING.md).
+ArcLight is a collaborative open source project where contributions are welcome. This contributing guide is borrowed in part from the [GeoBlacklight Contributing Guide](https://github.com/geoblacklight/geoblacklight/blob/main/CONTRIBUTING.md).
 
 ### Reporting issues
 
-Did you find a bug in ArcLight or interested in a new feature? Please make sure to add an issue for it in the [issue tracker](https://github.com/sul-dlss/arclight/issues) as follows:
+Did you find a bug in ArcLight or interested in a new feature? Please make sure to add an issue for it in the [issue tracker](https://github.com/projectblacklight/arclight/issues) as follows:
 
  - Make sure you have a [GitHub account](https://github.com/signup/free)
- - Submit a new [Github issue](https://github.com/sul-dlss/arclight/issues) by:
+ - Submit a new [Github issue](https://github.com/projectblacklight/arclight/issues) by:
     - Clearly describing the issue
     - Provide a descriptive summary
     - Explain the expected behavior
@@ -20,7 +20,7 @@ ArcLight also welcomes code and documentation contributions. We follow the [pull
 
 #### Pull request overview
 
-1. Fork it ( http://github.com/sul-dlss/arclight/fork )
+1. Fork it ( http://github.com/projectblacklight/arclight/fork )
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
@@ -40,4 +40,4 @@ Here are some general rules to follow for merging pull requests.
 - If you are uncertain, bring other contributors into the conversation by creating a comment that includes their `@username`.
 - If you like the pull request, but want others to chime in, create a +1 comment and tag a user.
 
-If you wish to ask questions or participate further, see our general [README](https://github.com/sul-dlss/arclight/blob/master/README.md).
+If you wish to ask questions or participate further, see our general [README](https://github.com/projectblacklight/arclight/blob/main/README.md).

data/Gemfile

@@ -5,11 +5,9 @@ source 'https://rubygems.org'
 # Specify your gem's dependencies in arclight.gemspec
 gemspec
 
-gem 'rexml' if RUBY_VERSION >= '3'
-
 # BEGIN ENGINE_CART BLOCK
-# engine_cart: 1.1.0
-# engine_cart stanza: 0.10.0
+# engine_cart: 2.5.0
+# engine_cart stanza: 2.5.0
 # the below comes from engine_cart, a gem used to test this Rails engine gem in the context of a Rails app.
 file = File.expand_path('Gemfile', ENV['ENGINE_CART_DESTINATION'] || ENV['RAILS_ROOT'] || File.expand_path('.internal_test_app', File.dirname(__FILE__)))
 if File.exist?(file)
@@ -29,17 +27,19 @@ else
     else
       gem 'rails', ENV['RAILS_VERSION']
     end
-  end
 
-  case ENV['RAILS_VERSION']
-  when /^4.2/
-    gem 'coffee-rails', '~> 4.1.0'
-    gem 'responders', '~> 2.0'
-    gem 'sass-rails', '>= 5.0'
-  when /^4.[01]/
-    gem 'sass-rails', '< 5.0'
+    case ENV['RAILS_VERSION']
+    when /^6.0/
+      gem 'sass-rails', '>= 6'
+      gem 'webpacker', '~> 4.0'
+    when /^5.[12]/
+      gem 'sass-rails', '~> 5.0'
+      gem 'sprockets', '~> 3.7'
+      gem 'thor', '~> 0.20'
+    end
   end
 end
 # END ENGINE_CART BLOCK
 
+# Used by engine_cart if you need to change a specific version of a dependency
 eval_gemfile File.expand_path('spec/test_app_templates/Gemfile.extra', File.dirname(__FILE__))

data/README.md

@@ -6,17 +6,16 @@
 
 A Rails engine supporting discovery of archival materials, based on [Blacklight](https://projectblacklight.org/)
 
-> ℹ️ From August-October 2019, Stanford University, University of Michigan, Indiana University, Princeton University, and Duke University are collaborating on a second phase of ArcLight! See the [project board](https://github.com/projectblacklight/arclight/projects/2) or our [demo videos](https://www.youtube.com/playlist?list=PLMdUaIJ0G8QiIXZ_SFHASJErD14CJW-p5) to follow our work.
 
 ## Requirements
 
-* [Ruby](https://www.ruby-lang.org/en/) 2.6 or later
-* [Rails](http://rubyonrails.org) 5.2 or later
+* [Ruby](https://www.ruby-lang.org/en/) 2.7 or later
+* [Rails](http://rubyonrails.org) 6.1 or later
 * Solr 8.1 or later
 
 ## Installation
 
-[Installing ArcLight](https://github.com/sul-dlss/arclight/wiki/Creating,-installing,-and-running-your-ArcLight-application) is straightforward in a Rails environment.
+[Installing ArcLight](https://github.com/projectblacklight/arclight/wiki/Creating,-installing,-and-running-your-ArcLight-application) is straightforward in a Rails environment.
 
 Basically, add this line to your application's `Gemfile`:
 
@@ -36,7 +35,7 @@ Or install it yourself as:
 $ gem install arclight
 ```
 
-For further details, see our [Installing ArcLight](https://github.com/sul-dlss/arclight/wiki/Creating,-installing,-and-running-your-ArcLight-application) documentation.
+For further details, see our [Installing ArcLight](https://github.com/projectblacklight/arclight/wiki/Creating,-installing,-and-running-your-ArcLight-application) documentation.
 
 ## Usage
 
@@ -48,9 +47,9 @@ Browsing allows you to view the Overview or Contents (when it exists) of a colle
 
 Some pages include an inline view tab to the right of an item which will expand the Contents further.
 
-See the [ArcLight demo](https://arclight-demo.projectblacklight.org/) and [ArcLight MVP Wiki](https://github.com/sul-dlss/arclight/wiki) for usage.
+See the [ArcLight demo](https://arclight-demo.projectblacklight.org/) and [ArcLight MVP Wiki](https://github.com/projectblacklight/arclight/wiki) for usage.
 
-See [Arclight Major Features](https://github.com/sul-dlss/arclight/wiki/Arclight-Major-Features) for a list of features.
+See [Arclight Major Features](https://github.com/projectblacklight/arclight/wiki/Arclight-Major-Features) for a list of features.
 
 ### Traject indexing of EAD content
 [Traject](https://github.com/traject/traject) is a high performance way of transforming documents for indexing into Solr and how ArcLight does indexing. An EAD2 can be indexed by doing the following:
@@ -70,7 +69,7 @@ bundle exec rake arclight:seed
 * General
   * [ArcLight demo site](https://arclight-demo.projectblacklight.org/)
   * [ArcLight project wiki](https://bit.ly/arclightproject): includes design process documentation
-  * [ArcLight Github Wiki](https://github.com/sul-dlss/arclight/wiki): developer/implementor documentation
+  * [ArcLight Github Wiki](https://github.com/projectblacklight/arclight/wiki): developer/implementor documentation
   * [Blacklight wiki](https://github.com/projectblacklight/blacklight/wiki)
   * Use the [ArcLight Google Group](http://groups.google.com/d/forum/arclight-community) to contact us with questions
 * ArcLight Phase II:
@@ -85,7 +84,7 @@ See the [CONTRIBUTORS](CONTRIBUTORS.md) file.
 
 ## Development
 
-ArcLight development uses [`solr_wrapper`](https://rubygems.org/gems/solr_wrapper/versions/0.18.1) and [`engine_cart`](https://rubygems.org/gems/engine_cart) to host development instances of Solr and Rails server on your local machine.
+ArcLight requires Solr to be running.  For development you can start this using `solr_wrapper` or you may choose to use Docker. Start Solr using Docker by doing `docker compose up`.
 
 ### Run the test suite
 
@@ -108,16 +107,23 @@ Then visit http://localhost:3000. It will also start a Solr instance on port 898
 
 You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
-### Release a new version of the gem
+### Releasing
 
-To release a new version:
+#### To release a new gem:
 
 1. Update the version number in `lib/arclight/version.rb`
 2. Run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, build the gem file (e.g., `gem build arclight.gemspec`) and push the `.gem` file to [rubygems.org](https://rubygems.org) (e.g., `gem push arclight-x.y.z.gem`).
 
+#### To release the frontend sources:
+
+When any of the javascript components or SASS sources in the gem are changed, this package should be published to NPM with the following steps:
+1. [Install npm](https://www.npmjs.com/get-npm)
+2. Bump the version number in `package.json`
+3. run `npm publish` to push the javascript package to https://npmjs.org/package/arclight
+
 ## Contributing
 
-[Bug reports](https://github.com/sul-dlss/arclight/issues) and [pull requests](https://github.com/sul-dlss/arclight/pulls) are welcome on ArcLight -- see [CONTRIBUTING.md](https://github.com/sul-dlss/arclight/blob/master/CONTRIBUTING.md) for details.
+[Bug reports](https://github.com/projectblacklight/arclight/issues) and [pull requests](https://github.com/projectblacklight/arclight/pulls) are welcome on ArcLight -- see [CONTRIBUTING.md](https://github.com/projectblacklight/arclight/blob/main/CONTRIBUTING.md) for details.
 ## License
 
 The gem is available as open source under the terms of the [Apache 2 License](https://opensource.org/licenses/Apache-2.0).

data/app/assets/javascripts/arclight/arclight.js

@@ -1,8 +1,4 @@
-//= require arclight/collection_scrollspy
-//= require arclight/collection_navigation
-//= require arclight/context_navigation
-//= require arclight/oembed_viewer
-//= require arclight/truncator
+import 'arclight/oembed_viewer'
 
-// Vendor Scripts
-//= require responsiveTruncator
+import Truncate from 'arclight/truncate_controller'
+Stimulus.register('arclight-truncate', Truncate)

data/app/assets/javascripts/arclight/oembed_viewer.js

@@ -1,46 +1,71 @@
-Blacklight.onLoad(function () {
-  'use strict';
+class OembedLoader {
+  constructor(el) {
+    this.el = el
+  }
 
-  var onlineContentTabSelector = '[data-arclight-online-content-tab="true"]';
-  var oEmbedViewerSelector = '[data-arclight-oembed="true"]';
+  load() {
+    const loadedAttr = this.el.getAttribute('loaded')
+    const { arclightOembed, arclightOembedUrl, ...extraOembedParams } = this.el.dataset
+    const extraParams = OembedLoader.normalizeParams(extraOembedParams)
 
-  $(onlineContentTabSelector).on('shown.bs.tab', function () {
-    var $viewerElements = $(oEmbedViewerSelector);
-    if ($viewerElements.length === 0) {
-      return;
+    if (loadedAttr && loadedAttr === 'loaded') {
+      return
     }
 
-    $viewerElements.each(function (i, element) {
-      var $el = $(element);
-      var loadedAttr = $el.attr('loaded');
-      var data = $el.data();
-      var resourceUrl = data.arclightOembedUrl;
-      if (loadedAttr && loadedAttr === 'loaded') {
-        return;
-      }
-
-      $.ajax({
-        url: resourceUrl,
-        dataType: 'html'
-      }).done(function (response) {
-        var links = $('<div>' + response.match(/<link .*>/g).join('') + '</div>'); // Parse out link elements so image assets are not loaded
-        var oEmbedEndPoint = links.find('link[rel="alternate"][type="application/json+oembed"]').prop('href');
-
+    fetch(arclightOembedUrl)
+      .then((response) => response.text())
+      .then((body) => {
+        const oEmbedEndPoint = OembedLoader.findOEmbedEndPoint(body, extraParams)
         if (!oEmbedEndPoint || oEmbedEndPoint.length === 0) {
-          return;
+          console.warn(`No oEmbed endpoint found in <head> at ${arclightOembedUrl}`)
+          return
         }
+        this.loadEndPoint(oEmbedEndPoint)
+      })
+  }
+
+  // Convert data-arclight-oembed-* attributes to URL parameters for the viewer
+  static normalizeParams(attributes) {
+    return Object.keys(attributes).reduce((acc, attribute) => {
+      // Reverse data attribute name conversion. See:
+      // https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/dataset#name_conversion
+      const parameterName = attribute.replace('arclightOembed', '')
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .toLowerCase()
+
+      acc[parameterName] = attributes[attribute]
+      return acc
+    }, {})
+  }
+
+  static findOEmbedEndPoint(body, extraParams = {}) {
+    // Parse out link elements so image assets are not loaded
+    const template = document.createElement('template')
+    template.innerHTML = body.match(/<link .*>/g).join('')
 
-        $.ajax({
-          url: oEmbedEndPoint
-        }).done(function (oEmbedResponse) {
-          if (oEmbedResponse.html) {
-            $el.hide()
-               .html(oEmbedResponse.html)
-               .fadeIn(500);
-            $el.attr('loaded', 'loaded');
-          }
-        });
-      });
-    });
-  });
-});
+    // Look for a link element containing the oEmbed endpoint; bail out if none
+    const endpoint = template.content.querySelector('link[rel="alternate"][type="application/json+oembed"]')
+      ?.getAttribute('href')
+    if (!endpoint) return ''
+
+    // Serialize any extra params and append them to the endpoint
+    const qs = new URLSearchParams(extraParams).toString()
+    return `${endpoint}&${qs}`
+  }
+
+  loadEndPoint(oEmbedEndPoint) {
+    fetch(oEmbedEndPoint)
+      .then((response) => response.json())
+      .then((json) => {
+        this.el.innerHTML = json.html
+        this.el.setAttribute('loaded', 'loaded')
+      })
+  }
+}
+
+Blacklight.onLoad(function () {
+  document.querySelectorAll('[data-arclight-oembed="true"]').forEach((element) => {
+    const loader = new OembedLoader(element)
+    loader.load()
+  })
+})

data/app/assets/javascripts/arclight/truncate_controller.js

@@ -0,0 +1,27 @@
+import { Controller } from '@hotwired/stimulus'
+
+export default class extends Controller {
+  static targets = ['content']
+
+  connect() {
+    // target elements
+    const contentInner = Array.from(this.contentTarget.children)
+
+    // calculate total scrollable inner height vs. observed outer height
+    const outerHeight = this.contentTarget.clientHeight
+    const innerHeight = contentInner.map(e => e.scrollHeight).reduce((a, b) => a + b, 0)
+
+    // truncation occurred if total inner height exceeds outer (observed) height.
+    // if no longer truncated, reset the expanded state (e.g. on window resize).
+    if (innerHeight > outerHeight) {
+      this.element.classList.add('truncated')
+    } else {
+      this.element.classList.remove('truncated')
+      this.contentTarget.classList.remove('expanded')
+    }
+  }
+
+  trigger() {
+    this.element.classList.toggle('expanded')
+  }
+}

data/app/assets/stylesheets/arclight/application.scss

@@ -1,7 +1,3 @@
-@import 'bootstrap/functions';
-@import 'bootstrap/variables';
-@import 'bootstrap/mixins/breakpoints';
-@import 'bootstrap_overrides';
 @import 'variables';
 @import 'responsive';
 @import 'modules/collection_search';
@@ -14,4 +10,4 @@
 @import 'modules/repository_card.scss';
 @import 'modules/search_results';
 @import 'modules/show_collection';
-@import 'modules/context_navigation'
+@import 'modules/truncator';