From 67c12c131650fa79e91f74a33329e7eee2034d68 Mon Sep 17 00:00:00 2001
From: Alex Velez <velezllaquealex@gmail.com>
Date: Thu, 26 Dec 2024 15:54:19 -0500
Subject: [PATCH] Clean code and add comments

---
 lib/KModal.vue                           |  7 ++++---
 lib/KSelect/index.vue                    | 26 +++++++++++++-----------
 lib/KTooltip/index.vue                   |  3 +--
 lib/{KTooltip/Popper.vue => _Popper.vue} |  5 +++++
 4 files changed, 24 insertions(+), 17 deletions(-)
 rename lib/{KTooltip/Popper.vue => _Popper.vue} (96%)

diff --git a/lib/KModal.vue b/lib/KModal.vue
index 1dc030268..b5e4e6835 100644
--- a/lib/KModal.vue
+++ b/lib/KModal.vue
@@ -14,14 +14,13 @@
           @keyup.esc.stop="emitCancelEvent"
           @keyup.enter="handleEnter"
         >
-          <!-- KeenUiSelect targets modal by using div.modal selector -->
           <div
             ref="modal"
             class="modal"
             :tabindex="0"
             role="dialog"
             aria-labelledby="modal-title"
-            :style="[modalSizeStyles, { background: $themeTokens.surface }, { overflowY: 'auto' }]"
+            :style="modalStyles"
           >
             <!-- Modal Title -->
             <h1
@@ -216,11 +215,13 @@
       };
     },
     computed: {
-      modalSizeStyles() {
+      modalStyles() {
         return {
           'max-width': `${this.maxModalWidth - 32}px`,
           'max-height': `${this.windowHeight - 32}px`,
           width: this.modalWidth,
+          background: this.$themeTokens.surface,
+          overflowY: 'auto',
         };
       },
       modalWidth() {
diff --git a/lib/KSelect/index.vue b/lib/KSelect/index.vue
index c82c3d7ad..b7ca08ebf 100644
--- a/lib/KSelect/index.vue
+++ b/lib/KSelect/index.vue
@@ -201,7 +201,7 @@
   import { looseIndexOf, looseEqual } from '../keen/helpers/util';
   import { scrollIntoView, resetScroll } from '../keen/helpers/element-scroll';
   import config from '../keen/config';
-  import Popper from '../KTooltip/Popper.vue';
+  import Popper from '../_Popper.vue';
   import _useOverlay from '../composables/_useOverlay';
   import KSelectOption from './KSelectOption.vue';
 
@@ -241,6 +241,9 @@
 
       onMounted(() => {
         const overlayEl = getOverlayEl();
+        // set appendToEl on mounted to avoid SSR issues, and to wait for the component
+        // to be mounted before rendering the popper component, as it needs
+        // the reference to be rendered first
         appendToEl.value = overlayEl;
       });
 
@@ -377,7 +380,6 @@
     data() {
       return {
         query: '',
-        isInsideModal: false,
         isActive: false,
         isTouched: false,
         highlightedOption: null,
@@ -480,6 +482,7 @@
             applyStyle: {
               enabled: true,
               fn: throttle(data => {
+                // Set the width of the dropdown to match the width of the label
                 data.styles.width = `${data.offsets.reference.width}px`;
                 Object.assign(data.instance.popper.style, data.styles);
                 return data;
@@ -487,6 +490,9 @@
             },
             preventOverflow: {
               enabled: true,
+              // Set boundaries to be the viewport so that the dropdown is not cut off
+              // by the parent container, and can calculate the flip behavior having the
+              // viewport as reference
               boundariesElement: 'viewport',
             },
           },
@@ -618,14 +624,6 @@
       }
     },
 
-    mounted() {
-      // look for KSelects nested within modals
-      const allSelects = document.querySelectorAll('div.modal div.ui-select');
-      // create array from a nodelist [IE does not support Array.from()]
-      const allSelectsArr = Array.prototype.slice.call(allSelects);
-      this.isInsideModal = allSelectsArr.includes(this.$el);
-    },
-
     methods: {
       setValue(value) {
         value = value ? value : this.multiple ? [] : '';
@@ -800,8 +798,8 @@
 
       async closeDropdown(options = { autoBlur: false }) {
         this.$refs.dropdownPopper.doClose();
-        await this.$nextTick();
         if (!options.autoBlur) {
+          await this.$nextTick();
           this.$refs.label.focus();
           this.isActive = true;
         }
@@ -826,6 +824,8 @@
       },
 
       selectBlur() {
+        // A diffent blur (other than the `onBlur` method) is needed for the label
+        // to prevent the dropdown from closing
         if (!this.isDropdownOpen) {
           this.isActive = false;
         }
@@ -879,7 +879,8 @@
         this.$emit('dropdown-close');
       },
 
-      scrollOptionIntoView(optionEl) {
+      async scrollOptionIntoView(optionEl) {
+        await this.$nextTick();
         scrollIntoView(optionEl, {
           container: this.$refs.optionsList,
           marginTop: 180,
@@ -1081,6 +1082,7 @@
   .ui-select-dropdown {
     @extend %dropshadow-2dp;
 
+    position: absolute;
     z-index: $z-index-dropdown;
     margin-top: 2px;
     list-style-type: none;
diff --git a/lib/KTooltip/index.vue b/lib/KTooltip/index.vue
index bca49feb0..53f593c87 100644
--- a/lib/KTooltip/index.vue
+++ b/lib/KTooltip/index.vue
@@ -34,8 +34,7 @@
 
   import isArray from 'lodash/isArray';
   import _useOverlay from '../composables/_useOverlay';
-  import Popper from './Popper';
-
+  import Popper from '../_Popper';
   /**
    * Used to create a tooltip.
    */
diff --git a/lib/KTooltip/Popper.vue b/lib/_Popper.vue
similarity index 96%
rename from lib/KTooltip/Popper.vue
rename to lib/_Popper.vue
index 7ce6c7f15..04acfdaa4 100644
--- a/lib/KTooltip/Popper.vue
+++ b/lib/_Popper.vue
@@ -9,6 +9,7 @@
      - Allow for appending to a chosen element rather than to body,
        typically to the overlay container element #k-overlay.
        'appendToBody' prop changedto 'appendToEl' and related changes.
+     - Add 'closeOnScroll' prop to close the popper on scroll.
   -->
 
   <span>
@@ -220,12 +221,16 @@
         this.showPopper = false;
       },
 
+      // Debouncing as we don't need to check this on every scroll event on a
+      // "scroll session", just the first one, and although very unlikely, the last one
       doCloseOnScroll: debounce(
         function (event) {
           const popperEl = this.$refs.popper;
           if (
             !popperEl ||
+            // ignore scrolls inside the popper
             this.elementContains(popperEl, event.target) ||
+            // ignore scrolls unrelated to the popper reference, just from the ancestors
             !this.elementContains(event.target, this.referenceElm)
           ) {
             return;