j1-template 2022.1.0 → 2022.1.3

data/lib/starter_web/_data/{apps → modules}/justifiedGallery.yml

@@ -1,5 +1,5 @@
 # ------------------------------------------------------------------------------
-# ~/_data/apps/justifiedGallery.yml
+# ~/_data/modules/justifiedGallery.yml
 # User configuration for J1 Justified Gallery (jg)
 #
 # Product/Info:
@@ -62,7 +62,7 @@ settings:
   #   values:                           string
   #   default:                          /assets/data/galleries.json
   #
-  enabled:                              true                                    # needed for j1.layout_shim_generator.html
+  enabled:                              true
   xhr_data_path:                        /assets/data/galleries.json
   instance_type:                        multiple
   rowHeight:                            170
@@ -219,8 +219,8 @@ settings:
         id:                             jg_video_html5
         show_delay:                     300
         title:                          false                                   # HTML5 Video Gallery
-        css_classes:
-        video_path:                     "https://github.com/jekyll-one-org/jekyll-one-lfs/raw/master/videos"
+        theme:                          city
+        video_path:                     /assets/videos/gallery/html5
         image_path:                     /assets/videos/gallery
         thumb_path:                     /assets/videos/gallery
         videos:                         [
@@ -263,10 +263,10 @@ settings:
         image_path:                     /assets/videos/gallery
         thumb_path:                     /assets/videos/gallery
         videos:                         [
-                                          "https://www.youtube.com/watch?v=X5Cfi7U4eL4",
-                                          "https://www.youtube.com/watch?v=Nck6BZga7TQ",
-                                          "https://www.youtube.com/watch?v=F2SXmzk8ve4",
-                                          "https://www.youtube.com/watch?v=ln3wAdRAim4"
+                                          "//youtube.com/watch?v=X5Cfi7U4eL4",
+                                          "//youtube.com/watch?v=Nck6BZga7TQ",
+                                          "//youtube.com/watch?v=F2SXmzk8ve4",
+                                          "//youtube.com/watch?v=ln3wAdRAim4"
                                         ]
         captions_gallery:               [
                                           "Carpool Karaoke - Lady Gaga",
@@ -296,7 +296,59 @@ settings:
           videojsOptions:               {}
 
     # --------------------------------------------------------------------------
-    # Online VIDEO (Vimeo)
+    # Online VIDEO 2 (YouTube)
+    #
+    - gallery:
+        enabled:                        true
+        type:                           video-online
+        id:                             jg_video_online_youtube_2
+        show_delay:                     300
+        title:                          false                                   # YouTube Video Gallery
+        css_classes:
+        image_path:                     /assets/videos/gallery/voice_kids_de_2021
+        thumb_path:                     /assets/videos/gallery/voice_kids_de_2021
+        videos:                         [
+                                          "//youtube.com/watch?v=aQqPgLMgO-I",
+                                          "//youtube.com/watch?v=Bl6tkAgaP1g",
+                                          "//youtube.com/watch?v=GuiOYCv9NTI",
+                                          "//youtube.com/watch?v=1bvE2mgJ22I"
+                                        ]
+        player_params:                  [
+                                          "start: 0, end: 148",
+                                          "start: 0, end: 122",
+                                          "start: 0, end: 104",
+                                          "start: 10, end: 173"
+                                        ]
+
+        captions_gallery:               [
+                                          "The Voice Kids Germany 2021 - Constance",
+                                          "The Voice Kids Germany 2021 - Elisa",
+                                          "The Voice Kids Germany 2021 - Ben",
+                                          "The Voice Kids Germany 2021 - The Battle"
+                                        ]
+        captions_lightbox:              [
+                                          "<p>14-year-old Constance has dreamed of being on The Voice Kids stage for a very long time. Your dream has finally come true! She performs a breathtaking version of Sia's song Alive.</p>",
+                                          "<p>14-year-old Elisa is fascinated by the classics of pop music. Her version of Hey Jude from The Beatles comes with a lot of feeling.</p>",
+                                          "<p>14-year-old Ben pours all of his emotions into his performance of Maroon 5's Sunday Morning. He wants to show what he's made of.</p>",
+                                          "<p>The battle of the three young people is a real emotional battle. Elisa's husky voice, Constanze's unbelievable power, and Ben's rhythm come into their own in Adele's James Bond theme song Skyfall.</p>"
+                                        ]
+        poster:                         [
+                                          constance.jpg, elisa.jpg,
+                                          ben.jpg, battle.jpg
+                                        ]
+        gallery_options:
+          rowHeight:                    200
+          margins:                      5
+
+        lightbox_options:
+          lightbox:                     lg
+#         mode:                         lg-fade
+#         cssEasing:                    cubic-bezier(0.25, 0, 0.25, 1)
+          videojs:                      true
+          videojsOptions:               {}
+
+    # --------------------------------------------------------------------------
+    # Online VIDEO 3 (Vimeo)
     #
     - gallery:
         enabled:                        true
@@ -312,8 +364,8 @@ settings:
         image_path:                     /assets/videos/gallery
         thumb_path:                     /assets/videos/gallery
         videos:                         [
-                                          "https://vimeo.com/175582480",
-                                          "https://vimeo.com/179528528"
+                                          "//vimeo.com/175582480",
+                                          "//vimeo.com/179528528"
                                         ]
         captions_gallery:               [
                                           "Vogue -  Adriana Lima",
@@ -335,33 +387,37 @@ settings:
           lightbox:                     lg
 
     # --------------------------------------------------------------------------
-    # Tutorial Videos (HTML5 VIDEO)
+    # Online VIDEO (DailyMotion)
     #
     - gallery:
         enabled:                        true
-        type:                           video-html5                             # video-html5
-        id:                             jg_video_intro
+        type:                           video-online
+        id:                             jg_video_online_dailymotion
         show_delay:                     300
-        title:                          false                                   # Introduction Videos
+        title:                          false                                   # DailyMotion Video Gallery
+        thumb_items:                    2
+        thumb_spacing:                  5
+        thumb_bordered:                 true
+        thumb_animate:                  true
         css_classes:
-        video_path:                     /assets/videos/tutorials
-        image_path:                     /assets/videos/tutorials
-        thumb_path:                     /assets/videos/tutorials
+        image_path:                     /assets/videos/gallery/dailymotion
+        thumb_path:                     /assets/videos/gallery/dailymotion
         videos:                         [
-                                          web-erzeugen.1.mp4,
-                                          web-erzeugen.2.mp4
+                                          "//dai.ly/x887s09",
+                                          "//dai.ly/x87ycik"
                                         ]
+
         captions_gallery:               [
-                                          "Ein Starter Web erzeugen",
-                                          "Noch ein Starter Web erzeugen"
+                                          "Guided Meditation: Morning Energy",
+                                          "Beginner Mat Pilates: Core Workout"
                                         ]
         captions_lightbox:              [
-                                          "<p>Ein Starter Web erzeugen</p>",
-                                          "<p>Noch ein Starter Web erzeugen</p>"
+                                          "<p>Guided Meditation: Morning Energy</p>",
+                                          "<p>Beginner Mat Pilates: Core Workout</p>"
                                         ]
         poster:                         [
-                                          web-erzeugen-poster.jpg,
-                                          web-erzeugen-poster.jpg
+                                          meditation.jpg,
+                                          pilates.jpg
                                         ]
         gallery_options:
           rowHeight:                    200
@@ -369,50 +425,45 @@ settings:
 
         lightbox_options:
           lightbox:                     lg
-#         mode:                         lg-fade
-#         cssEasing:                    cubic-bezier(0.25, 0, 0.25, 1)
-          videojs:                      true
-          videojsOptions:               {}
 
     # --------------------------------------------------------------------------
-    # TikTok
+    # Online VIDEO (VK)
     #
     - gallery:
         enabled:                        true
         type:                           video-online
-        id:                             jg_tiktok
+        id:                             jg_video_online_vk
         show_delay:                     300
-        title:                          false
+        title:                          false                                   # VK Video Gallery
+        thumb_items:                    2
+        thumb_spacing:                  5
+        thumb_bordered:                 true
+        thumb_animate:                  true
         css_classes:
-        image_path:                     /assets/videos/tiktok
-        thumb_path:                     /assets/videos/tiktok
+        image_path:                     /assets/videos/gallery/vk
+        thumb_path:                     /assets/videos/gallery/vk
         videos:                         [
-                                          "https://www.tiktok.com/@octaviaegon/video/6983746143356292357/",
-                                          "https://www.tiktok.com/@waluschka.w59/video/6984680288114756870/",
-                                          "https://www.tiktok.com/@octaviaegon/video/6983746143356292357/",
+                                          "//vk.com/video_ext.php?oid=-114944820&id=456242413&hash=ef5be3f71500f8df",
+                                          "//vk.com/video_ext.php?oid=-114944820&id=456239717&hash=f6651448bfb14b90"
                                         ]
         captions_gallery:               [
-                                        "Egon - Einhorn",
-                                        "Valentina - Mahlzeit!",
-                                        "Egon - Einhorn",
+                                          "Otter plague",
+                                          "Looked at the shark's mouth (whale shark)"
                                         ]
         captions_lightbox:              [
-                                          "<p>Egon - Einhorn</p>",
-                                          "<p>Valentina - Mahlzeit!</p>",
-                                          "<p>Egon - Einhorn</p>"
+                                          "<p>Otter plague</p>",
+                                          "<p>Looked at the shark's mouth (whale shark)</p>"
                                         ]
-        poster:                         [                                       # thumbnails taken from https://www.tiktok.com/oembed?url=xxx (thumbnail_url)
-                                          einhorn.jpg,                          # https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/dd93b5e1036b47f88ecd38fdc7305c4c~tplv-dmt-logom:tos-maliva-p-0000/a6315c6d8268486c931480b6fb1e3836.image?x-expires=1629579600&x-signature=lWUMEMNw%2Byf3tTX4YOdEGRrh1%2BQ%3D
-                                          waluschka.jpg,                        # https://p16-sign-va.tiktokcdn.com/obj/tos-maliva-p-0068/03a05accd4ec443aba51f4ec8a07d3a0?x-expires=1629583200&x-signature=t%2FvV5z4I9mdjtwAzH4FOF%2Fkm9fs%3D
-                                          einhorn.jpg
+        poster:                         [
+                                          otter.jpg,
+                                          hai.jpg
                                         ]
         gallery_options:
-          rowHeight:                    400
+          rowHeight:                    200
           margins:                      5
 
         lightbox_options:
           lightbox:                     lg
 
-
 # ------------------------------------------------------------------------------
 # END config

data/lib/starter_web/_data/{apps → modules}/lightGallery.yml

@@ -1,5 +1,5 @@
 # ------------------------------------------------------------------------------
-# ~/_data/apps/light_gallery.yml
+# ~/_data/modules/light_gallery.yml
 # User configuration settings for J1 LightGallery (lg)
 #
 # Product/Info:

data/lib/starter_web/_data/{apps → modules}/lightbox.yml

@@ -1,6 +1,6 @@
 # ------------------------------------------------------------------------------
-# ~/_data/apps/lightbox.yml
-# Default configuration for J1 Lightbox V2
+# ~/_data/modules/lightbox.yml
+# Default configuration for J1 Lightbox
 #
 # Product/Info:
 # https://jekyll.one

data/lib/starter_web/_data/modules/{quicksearch.yml → lunr.yml}

@@ -1,6 +1,6 @@
 # ------------------------------------------------------------------------------
-#  ~/_data/modules/quicksearch.yml
-#  User configuration settings for J1 QuickSearch module
+#  ~/_data/modules/lunr.yml
+#  User configuration settings for J1 Lunr (search) module
 #
 #  Product/Info:
 #  https://jekyll.one
@@ -16,9 +16,9 @@
 #
 description:
 
-  title:                                J1 QuickSearch
+  title:                                J1 Lunr
   scope:                                User settings
-  location:                             _data/modules/quicksearch.yml
+  location:                             _data/modules/lunr.yml
 
 # ------------------------------------------------------------------------------
 # User configuration settings
@@ -34,8 +34,5 @@ settings:
   stopwords_locale:                     en
   min_length:                           3
 
-  # currently NOT supported, use pagewise exclude_from_search: true|false
-  # excludes:                             [ /pages/public/blog/*, /pages/public/skeleton/* ]
-
 # ------------------------------------------------------------------------------
 # END config

data/lib/starter_web/_data/modules/navigator_menu.yml

@@ -81,7 +81,7 @@
 #
 - item:                                 Blog
   sublevel:
-    - title:                            Starter Blog
+    - title:                            Blog Navigator
       href:                             /pages/public/blog/navigator/
       icon:                             near-me
     - title:                            Categories

data/lib/starter_web/_data/modules/rangeSlider.yml

@@ -43,7 +43,7 @@ settings:
         id:                             example_slider
 
         options:
-          label:                        Example Slider 1
+          label:                        "Slider 1, range: [0,100], start at: 20"
           start:                        20
           range:
             min:                        0
@@ -57,7 +57,7 @@ settings:
         id:                             example_slider_2
 
         options:
-          label:                        Example Slider 2
+          label:                        "Slider 2, range: [0,200], start at: 80"
           start:                        80
           range:
             min:                        0

data/lib/starter_web/_data/resources.yml

@@ -360,22 +360,65 @@ resources:
                                           core/css/icon-fonts/mdil,
                                           core/css/icon-fonts/fontawesome,
                                           core/css/vendor
-
-                                        ]
-        files:                          [
-                                          adapter/js/j1.js,
-#                                         modules/cryptoJS/js/aes.js,
-#                                         "https://cdnjs.cloudflare.com/ajax/libs/crypto-js/3.1.2/rollups/aes.js"
                                         ]
+        files:                          [ adapter/js/j1.js ]
         js:                             [
-                                          modules/gtag-opt-in/js/gtag-opt-in,
                                           modules/jquery/js/jquery,
-                                          modules/jquery/js/jqueryUI,
-                                          modules/popper/js/popper,
+                                          modules/popper/js/popper,             # required for BS
                                           core/js/template
                                         ]
         init_function:                  [ j1.init ]
 
+  # ----------------------------------------------------------------------------
+  # Google Analytics OptIn, a browser library to opt-in in Google Analytics
+  # See: https://github.com/luciomartinez/gtag-opt-in
+  #
+  - name:                               gaOptIn
+    resource:
+      enabled:                          true
+
+      id:                               ga-opt-in
+      comment:                          gaOptIn
+      region:                           head
+      layout:                           [ all ]
+      required:                         always
+      preload:                          false
+      script_load:                      defer
+      dependencies:                     false
+      pass_init_data:                   false
+      data:
+        css:                            []
+        files:                          []
+        js:                             [ modules/gtag-opt-in/js/gtag-opt-in ]
+        init_function:                  []
+
+  # ----------------------------------------------------------------------------
+  # jQueryUI, curated set of user interface interactions, effects, widgets,
+  # and themes built on top of jQuery
+  # See: https://jqueryui.com/
+  #
+  - name:                               jQueryUI
+    resource:
+      enabled:                          true
+
+      id:                               jquery-ui
+      comment:                          jQueryUI
+      region:                           head
+      layout:                           [ all ]
+      required:                         ondemand
+      preload:                          false
+      script_load:                      defer
+      dependencies:                     false
+      pass_init_data:                   false
+      data:
+        css:                            [
+                                          modules/jquery/css/jquery-ui/jquery-ui,
+                                          modules/jquery/css/jquery-ui/jquery-ui.theme
+                                        ]
+        files:                          []
+        js:                             [ modules/jquery/js/jquery-ui ]
+        init_function:                  []
+
   # ----------------------------------------------------------------------------
   # J1 Logger, JS API for all logs used by J1 Template based on the
   # log4j implementation for JS (log4javascript)
@@ -787,31 +830,30 @@ resources:
   # of J1 Template based on the Lunr JS API
   # See: https://lunrjs.com/
   #
-  - name:                               QuickSearch
+  - name:                               Lunr
     resource:
       enabled:                          true
 
-      id:                               quicksearch
-      comment:                          J1 QuickSearch
+      id:                               lunr
+      comment:                          J1 Lunr
       region:                           head
       layout:                           [ all ]
-      required:                         always                                  # always | ondemand
-      preload:                          false                                   # property currently unused
+      required:                         always
+      preload:                          false
       script_load:                      defer
       dependencies:                     false
       pass_init_data:                   false
       data:
-        css:                            [ modules/lunrSearch/css/quicksearch ]
-        files:                          [ adapter/js/quicksearch.js ]
+        css:                            [ modules/lunr/css/j1 ]
+        files:                          [ adapter/js/lunr.js ]
         js:                             [
-                                          modules/lunrSearch/js/lunr,
-                                          modules/lunrSearch/js/mustache,
-                                          modules/lunrSearch/js/dateformat,
-                                          modules/lunrSearch/js/uri,
-#                                         modules/jquery/js/require,            # require.js currently unused, but conflicts with some modules
-                                          modules/lunrSearch/js/quicksearch
+                                          modules/lunr/js/lunr,
+                                          modules/lunr/js/mustache,
+                                          modules/lunr/js/dateformat,
+                                          modules/lunr/js/uri,
+                                          modules/lunr/js/j1
                                         ]
-        init_function:                  [ j1.adapter.quicksearch.init ]
+        init_function:                  [ j1.adapter.lunr.init ]
 
   # ----------------------------------------------------------------------------
   # rtextResizer (currently NOT used)
@@ -1004,7 +1046,7 @@ resources:
         init_function:                  []
 
   # ----------------------------------------------------------------------------
-  # Gallery Customizer, Customizer UI for Justified dGallery
+  # Gallery Customizer, Customizer UI for JustifiedGallery
   #
   - name:                               J1 Gallery Customizer
     resource:
@@ -1343,9 +1385,9 @@ resources:
       id:                               video_js
       comment:                          module videojs
       region:                           head
-      layout:                           [ home, page, post, collection, blog_archive ]
+      layout:                           [ all ]
       required:                         ondemand
-      preload:                          false                                   # property currently unused
+      preload:                          false
       script_load:                      defer
       dependencies:                     false
       pass_init_data:                   false
@@ -1371,9 +1413,9 @@ resources:
       id:                               vimeo_froogaloop
       comment:                          module vimeo_froogaloop
       region:                           head
-      layout:                           [ home, page, post, collection, blog_archive ]
+      layout:                           [ all ]
       required:                         ondemand
-      preload:                          false                                   # property currently unused
+      preload:                          false
       script_load:                      defer
       dependencies:                     false
       pass_init_data:                   false
@@ -1393,9 +1435,9 @@ resources:
       id:                               vimeo_player
       comment:                          module vimeo_player
       region:                           head
-      layout:                           [ home, page, post, collection, blog_archive ]
+      layout:                           [ all ]
       required:                         ondemand
-      preload:                          false                                   # property currently unused
+      preload:                          false
       script_load:                      defer
       dependencies:                     false
       pass_init_data:                   false
@@ -1416,7 +1458,7 @@ resources:
       id:                               rangeslider
       comment:                          module rangeSlider
       region:                           head
-      layout:                           [ page, post, collection, raw ]
+      layout:                           [ all ]
       required:                         ondemand
       preload:                          false
       script_load:                      defer

data/lib/starter_web/_includes/attributes.asciidoc

@@ -28,6 +28,11 @@ tag::urls[]
 :url-asciidoctor--extensions-use:                 https://github.com/asciidoctor/asciidoctor-extensions-lab#using-an-extension
 :url-asciidoctor--extensions-manual:              http://asciidoctor.org/docs/user-manual/#extensions
 
+:url-alexa-scores--youtube:                       https://www.alexa.com/siteinfo/youtube.com
+:url-alexa-scores--vimeo:                         https://www.alexa.com/siteinfo/vimeo.com
+:url-alexa-scores--dailymotion:                   https://www.alexa.com/siteinfo/dailymotion.com
+:url-alexa-scores--vk:                            https://www.alexa.com/siteinfo/vk.com
+
 :url-babel-js--home:                              https://babeljs.io/
 :url-babel-js--gh-repo:                           https://github.com/babel/babel/
 
@@ -109,6 +114,8 @@ tag::urls[]
 :url-cross-env--gh-repo:                          https://github.com/kentcdodds/cross-env/
 :url-cross-var--gh-repo:                          https://github.com/elijahmanor/cross-var/
 
+:url-dailymotion--home:                           https://www.dailymotion.com/
+
 :url-datatables--home:                            https://datatables.net/
 :url-docker--home:                                https://getbootstrap.com/
 :url-docker--docs:                                https://docs.docker.com/
@@ -289,9 +296,9 @@ tag::urls[]
 :url-popper--gh-repo:                             https://github.com/popperjs/popper-core/
 
 :url-previewer--county-flags:                     https://jekyll.one/pages/public/previewer/country_flags/
-:url-previewer--emoji:                            http://localhost:42000/pages/public/previewer/twitter_emoji/
-:url-previewer--mdi-icons:                        http://localhost:42000/pages/public/previewer/mdi_font/
-:url-previewer--rouge-themes:                     http://localhost:42000/pages/public/previewer/rouge/
+:url-previewer--emoji:                            https://jekyll.one/pages/public/previewer/twitter_emoji/
+:url-previewer--mdi-icons:                        https://jekyll.one/pages/public/previewer/mdi_font/
+:url-previewer--rouge-themes:                     https://jekyll.one/pages/public/previewer/rouge/
 
 :url-puma--home:                                  https://puma.io/
 :url-puma--gh-repo:                               https://github.com/puma/puma/
@@ -360,6 +367,9 @@ tag::urls[]
 :url-vimeo--home:                                 https://vimeo.com/
 :url-vimeo--privacy-policy:                       https://vimeo.com/privacy
 
+:url-vivendi--home:                               https://www.vivendi.com/en/
+:url-vk--home:                                    https://vk.com/
+
 :url-webpack--home:                               https://webpack.js.org/
 :url-webpack--gh-repo:                            https://github.com/webpack/webpack/
 
@@ -486,6 +496,9 @@ tag::data[]
 
 :data-translator--icon:                           "pages/tools/translator-icon.jpg, QuickLinks - Translator Icon"
 
+:data-images-lightbox--standalone:                "modules/gallery/old_times/image_02.jpg, GrandPa's 80th Birthday"
+:data-images-lightbox--group:                     "modules/gallery/old_times/image_03.jpg, GrandPa's annual journey, modules/gallery/old_times/image_04.jpg, GrandPa's annual journey"
+
 end::data[]
 
 

data/lib/starter_web/_plugins/asciidoctor-extensions/lightbox-block.rb

@@ -45,11 +45,13 @@ Asciidoctor::Extensions.register do
       images_hash   = Hash[*attrs['image_data'].split(',')]
 
       title_html    = (attrs.has_key? 'title') ? %(<div class="title">#{attrs['title']}</div>\n) : nil
-      role          = (attrs.has_key? 'role') ? role : 'mb-3'
+      role          = (attrs.has_key? 'role') ? role : ''
       grouped       = (attrs.has_key? 'group') ? true : false
 
+      # {attrs['role']}
+
       if grouped
-        html_block.div(:class=>"content") {
+        html_block.div(:class=>"content #{attrs['role']}", :style=>"margin-bottom: .75rem;") {
           images_hash.each do |i,d|
             image = i.strip
             descr = d.strip
@@ -59,7 +61,7 @@ Asciidoctor::Extensions.register do
           end
         }
       else
-        html_block.div(:class=>"content") {
+        html_block.div(:class=>"content #{attrs['role']}", :style=>"margin-bottom: .75rem;") {
           images_hash.each do |i,d|
             image = i.strip
             descr = d.strip
@@ -72,7 +74,7 @@ Asciidoctor::Extensions.register do
       content = html_block.target! # See: https://stackoverflow.com/questions/4961609/extra-to-s-when-using-builder-to-generate-xml
 
       html = %(
-        <div id="lb-#{target}" class="imageblock #{role}">
+        <div id="lb-#{target}" class="imageblock">
           #{title_html}
           #{content}
         </div>

data/lib/starter_web/_plugins/filters.rb

@@ -130,6 +130,59 @@ module Jekyll
        input.to_s.gsub(Regexp.new(regex), replacement.to_s)
     end
 
+    # --------------------------------------------------------------------------
+    #  Managing Arrays
+    #   input - arr:  returns any elements from input that are NOT in arr
+    #   arr - input:  returns any elements from arr that are not in a
+    #   arr | input:  returns the unique set from input AND arr
+    #   arr & input:  returns the intersection elements of input AND arr
+    #   pipe (|):     returns the unique set of elements for BOTH arrays
+    #
+    #  Example|s:
+    #
+    #   {% assign input = '1,2,3,4,5' | split: ',' %}
+    #   {% assign arr   = '1,2,3' | split: ',' %}
+    #
+    #   {% assign difference    = input | difference: arr %}
+    #   {% assign union         = input | union: arr %}
+    #   {% assign intersection  = input | intersection: arr %}
+    #
+    #  NOTE
+    #    See: https://stackoverflow.com/questions/5678108/how-can-i-get-the-intersection-union-and-subset-of-arrays-in-ruby
+    #
+    # --------------------------------------------------------------------------
+    def difference(input, arr)
+      if ( input.kind_of?(Array) )
+        input - arr
+      else
+        []
+      end
+    end
+
+    # def difference_both_unique(input, arr)
+    #   if ( input.kind_of?(Array) )
+    #     input - arr | arr - input
+    #   else
+    #     []
+    #   end
+    # end
+
+    def union(input, arr)
+      if ( input.kind_of?(Array) )
+        input | arr
+      else
+        []
+      end
+    end
+
+    def intersection(input, arr)
+      if ( input.kind_of?(Array) )
+        input & arr
+      else
+        []
+      end
+    end
+
     # --------------------------------------------------------------------------
     #  strip_empty_lines:
     #