@lion/ui 0.17.0-menu-system.1 → 0.17.0

package/components/overlays/src/OverlayController.js

@@ -3,7 +3,6 @@ import { deepContains } from './utils/deep-contains.js';
 import { overlayShadowDomStyle } from './overlayShadowDomStyle.js';
 import { _adoptStyleUtils } from './utils/adopt-styles.js';
 import { getFocusableElements } from './utils/get-focusable-elements.js';
-import { isEqualConfig } from './utils/is-equal-config.js';
 
 /**
  * @typedef {import('@lion/ui/types/overlays.js').OverlayPhase} OverlayPhase
@@ -33,37 +32,27 @@ import { isEqualConfig } from './utils/is-equal-config.js';
  * `<slot name="my-content">` belonging to `<div slot="content"/>` will be wrapped with wrappingDialogNodeL1 and contentWrapperNodeL2
  * inside shadow dom. With the help of temp markers, `<slot name="my-content">`'s original position will be respected.
  *
- * @param {{
- *  wrappingDialogNodeL1: HTMLDialogElement|HTMLDivElement;
- *  contentWrapperNodeL2:Element;
- *  contentNodeL3: Element;
- * }} opts
+ * @param {{ wrappingDialogNodeL1:HTMLDialogElement|HTMLDivElement; contentWrapperNodeL2:Element; contentNodeL3: Element }} opts
  */
 function rearrangeNodes({ wrappingDialogNodeL1, contentWrapperNodeL2, contentNodeL3 }) {
-  // if contentWrapperNode is provided by the user,
-  // we assume it lives in shadow dom around a slot.
-  const hasLegacyMethodOfProvidingWrapperNode = Boolean(contentWrapperNodeL2.isConnected);
-  // We could be initialized via a directive (in offline dom). It's important that we know about the parents,
-  // as we cannot deal with single content nodes
-  const hasContentNodeAttachmentPoints = Boolean(contentNodeL3.parentNode);
-
-  if (!hasLegacyMethodOfProvidingWrapperNode && !hasContentNodeAttachmentPoints) {
+  if (!(contentWrapperNodeL2.isConnected || contentNodeL3.isConnected)) {
     throw new Error(
-      '[OverlayController] Could not find a render target, makes sure contentNode has a parent element (or contentWrapperNode is connected)',
+      '[OverlayController] Could not find a render target, since the provided contentNode is not connected to the DOM. Make sure that it is connected, e.g. by doing "document.body.appendChild(contentNode)", before passing it on.',
     );
   }
 
-  /** @type {Node} */
   let parentElement;
-  const tempMarker = document.createComment('overlay-insertion-marker');
+  const tempMarker = document.createComment('tempMarker');
 
-  if (hasLegacyMethodOfProvidingWrapperNode) {
+  if (contentWrapperNodeL2.isConnected) {
     // This is the case when contentWrapperNode (living in shadow dom, wrapping <slot name="my-content-outlet">) is already provided via controller.
     parentElement = contentWrapperNodeL2.parentElement || contentWrapperNodeL2.getRootNode();
     parentElement.insertBefore(tempMarker, contentWrapperNodeL2);
     // Wrap...
     wrappingDialogNodeL1.appendChild(contentWrapperNodeL2);
-  } else {
+  }
+  // if contentNodeL3.isConnected
+  else {
     const contentIsProjected = contentNodeL3.assignedSlot;
     if (contentIsProjected) {
       parentElement =
@@ -104,22 +93,7 @@ function rearrangeNodes({ wrappingDialogNodeL1, contentWrapperNodeL2, contentNod
    * ```
    */
   parentElement.insertBefore(wrappingDialogNodeL1, tempMarker);
-
-  return function cleanup() {
-    if (hasLegacyMethodOfProvidingWrapperNode) {
-      parentElement?.insertBefore(contentWrapperNodeL2, tempMarker);
-    } else {
-      parentElement?.insertBefore(contentNodeL3, tempMarker);
-      if (parentElement.contains(contentWrapperNodeL2)) {
-        contentWrapperNodeL2.remove();
-      }
-    }
-    parentElement?.removeChild(tempMarker);
-
-    if (parentElement.contains(wrappingDialogNodeL1)) {
-      parentElement?.removeChild(wrappingDialogNodeL1);
-    }
-  };
+  parentElement?.removeChild(tempMarker);
 }
 
 /**
@@ -132,21 +106,6 @@ async function preloadPopper() {
 
 const childDialogsClosedInEventLoopWeakmap = new WeakMap();
 
-/**
- * @param {HTMLElement | null} el
- * @param {string} selector
- * @returns {HTMLElement | null}
- */
-function deepClosest(el, selector) {
-  // @ts-ignore - comparing HTMLElement to document/window for safety
-  return (
-    // @ts-ignore - type comparison check
-    (el && el !== document && el !== window && el.closest(selector)) ||
-    // @ts-ignore - host property on ShadowRoot
-    deepClosest(el.getRootNode().host, selector)
-  );
-}
-
 /**
  * OverlayController is the fundament for every single type of overlay. With the right
  * configuration, it can be used to build (modal) dialogs, tooltips, dropdowns, popovers,
@@ -237,21 +196,10 @@ export class OverlayController extends EventTarget {
         placement: 'center',
       },
       zIndex: 9999,
-      // TODO: rename to isActivated
-      isOpenable: true,
-      focusContentOnOpen: false,
-      // This means that content will have visually-hidden / sr-only styles. This is handy for:
-      // - hidden menus that should be "indexable" by screen readers (like the Links list in VO: https://support.apple.com/en-gb/guide/voiceover/mchlp2719/mac)
-      // - "more" menus that put content in a dropdown that do not fit in the current row
-      // - menus that should generally open on tab.
-      // @ts-ignore - hideVisually is an extension property
-      hideVisually: false,
-      requireConnectedNodes: true,
     };
 
     /** @protected */
     this._contentId = `overlay-content--${Math.random().toString(36).slice(2, 10)}`;
-
     /** @private */
     this.__originalAttrs = new Map();
     /** @private */
@@ -272,8 +220,6 @@ export class OverlayController extends EventTarget {
     this.__escKeyHandlerCalled = false;
   }
 
-  #hasSetup = false;
-
   /**
    * The invokerNode
    * @type {HTMLElement | undefined}
@@ -292,7 +238,7 @@ export class OverlayController extends EventTarget {
 
   /**
    * Determines the connection point in DOM (body vs next to invoker).
-   * @type {'global' | 'local' | 'custom' | undefined}
+   * @type {'global' | 'local' | undefined}
    */
   get placementMode() {
     return this.config?.placementMode;
@@ -517,14 +463,17 @@ export class OverlayController extends EventTarget {
    * @param { OverlayConfig } cfgToAdd
    */
   updateConfig(cfgToAdd) {
+    // Teardown all previous configs
+    this.teardown();
+
     /**
      * @type {OverlayConfig}
      * @private
      */
-    const prevConfig = this.config;
+    this.__prevConfig = this.config;
 
     /** @type {OverlayConfig} */
-    const newConfig = {
+    this.config = {
       ...this._defaultConfig, // our basic ingredients
       ...this.__sharedConfig, // the initial configured overlayController
       ...cfgToAdd, // the added config
@@ -540,18 +489,12 @@ export class OverlayController extends EventTarget {
       },
     };
 
-    const shouldUpdate = !this.#hasSetup || !isEqualConfig(prevConfig, newConfig);
-    if (!shouldUpdate) return;
-    // Teardown all previous configs
-
-    this.teardown();
-
-    this.config = newConfig;
-
     /** @private */
     this.__validateConfiguration(this.config);
     /** @protected */
     this._init();
+    /** @private */
+    this.__elementToFocusAfterHide = undefined;
 
     if (!this.#isRegisteredOnManager()) {
       this.manager.add(this);
@@ -573,7 +516,7 @@ export class OverlayController extends EventTarget {
         '[OverlayController] You need to provide a .placementMode ("global"|"local")',
       );
     }
-    if (!['global', 'local', 'custom'].includes(newConfig.placementMode)) {
+    if (!['global', 'local'].includes(newConfig.placementMode)) {
       throw new Error(
         `[OverlayController] "${newConfig.placementMode}" is not a valid .placementMode, use ("global"|"local")`,
       );
@@ -592,23 +535,14 @@ export class OverlayController extends EventTarget {
    * @protected
    */
   _init() {
-    if (!this.config.isOpenable) return;
-
-    // TODO: should not be behind a flag when we are fully tearing down...
-    // TODO 2: When we move away from dialog (use popover to paint to top layer)
-    // and popper.js, (use popover and anchor positioning and popperjs as fallback, but we can put styles on contentNode),
-    // we dont need to create complex wrappers
-    // if (!this.__contentHasBeenInitialized) {
-    this.__initContentDomStructure();
-    // this.__contentHasBeenInitialized = true;
-    // }
-    this.__initVisibility();
+    if (!this.__contentHasBeenInitialized) {
+      this.__initContentDomStructure();
+      this.__contentHasBeenInitialized = true;
+    }
 
     // Reset all positioning styles (local, c.q. Popper) and classes (global)
-    if (this.contentWrapperNode !== this.contentNode) {
-      this.contentWrapperNode.removeAttribute('style');
-      this.contentWrapperNode.removeAttribute('class');
-    }
+    this.contentWrapperNode.removeAttribute('style');
+    this.contentWrapperNode.removeAttribute('class');
 
     if (this.placementMode === 'local') {
       // Lazily load Popper as soon as the first local overlay is used...
@@ -618,27 +552,8 @@ export class OverlayController extends EventTarget {
     }
     this.__handleOverlayStyles({ phase: 'init' });
     this._handleFeatures({ phase: 'init' });
-
-    /** @private */
-    this.__elementToFocusAfterHide = undefined;
-
-    this.contentNode.dataset.content = '';
-
-    // Use event delegation to listen for clicks on close buttons...
-    this.contentNode.addEventListener('click', this.#hideOnCloseButtonClick);
-
-    this.#hasSetup = true;
   }
 
-  #hideOnCloseButtonClick = (/** @type {{ target: any; }} */ ev) => {
-    const isOurCloseButton =
-      ev.target.hasAttribute('data-close') &&
-      deepClosest(ev.target, '[data-content]') === this.contentNode;
-    if (!isOurCloseButton) return;
-
-    this.hide();
-  };
-
   /**
    * @param {{ phase: OverlayPhase }} config
    * @private
@@ -679,108 +594,84 @@ export class OverlayController extends EventTarget {
    * @private
    */
   __initContentDomStructure() {
-    if (this.placementMode !== 'custom') {
-      const wrappingDialogElement = document.createElement('dialog');
-      // We use a dialog for its visual capabilities: it renders to the top layer.
-      // A11y will depend on the type of overlay and is arranged on contentNode level.
-      // Also see: https://www.scottohara.me/blog/2019/03/05/open-dialog.html
-      //
-      // The role="dialog" is set on the contentNode (or another role), so role="none"
-      // is valid here, although AXE complains about this setup.
-      // For now we need to add `ignoredRules: ['aria-allowed-role']` in your AXE tests.
-      // see: https://lion.js.org/fundamentals/systems/overlays/rationale/#considerations
-      wrappingDialogElement.setAttribute('role', 'none');
-      wrappingDialogElement.setAttribute('data-overlay-outer-wrapper', '');
-      // N.B. position: fixed is needed to escape out of 'overflow: hidden'
-      // We give a high z-index for non-modal dialogs, so that we at least win from all siblings of our
-      // parent stacking context
-      // padding reset so we don't get a weird dialog visual square showing up
-      wrappingDialogElement.style.cssText = `display:none; z-index: ${this.config.zIndex}; padding: 0;`;
-      // @ts-ignore - 'custom' is a valid extension of placementMode
-      if (this.config.placementMode === 'custom') {
-        // The user should have full freedom to control the content node, so its wrapper nodes should remain neutral.
-        wrappingDialogElement.style.cssText += `position: static;`;
-      }
-      this.__wrappingDialogNode = wrappingDialogElement;
+    const wrappingDialogElement = document.createElement('dialog');
+    // We use a dialog for its visual capabilities: it renders to the top layer.
+    // A11y will depend on the type of overlay and is arranged on contentNode level.
+    // Also see: https://www.scottohara.me/blog/2019/03/05/open-dialog.html
+    //
+    // The role="dialog" is set on the contentNode (or another role), so role="none"
+    // is valid here, although AXE complains about this setup.
+    // For now we need to add `ignoredRules: ['aria-allowed-role']` in your AXE tests.
+    // see: https://lion.js.org/fundamentals/systems/overlays/rationale/#considerations
+    wrappingDialogElement.setAttribute('role', 'none');
+    wrappingDialogElement.setAttribute('data-overlay-outer-wrapper', '');
+    // N.B. position: fixed is needed to escape out of 'overflow: hidden'
+    // We give a high z-index for non-modal dialogs, so that we at least win from all siblings of our
+    // parent stacking context
+    // padding reset so we don't get a weird dialog visual square showing up
+    wrappingDialogElement.style.cssText = `display:none; z-index: ${this.config.zIndex}; padding: 0;`;
+    this.__wrappingDialogNode = wrappingDialogElement;
 
-      /**
-       * Based on the configuration of the developer, multiple scenarios are accounted for
-       * A. We already have a contentWrapperNode ()
-       */
-      if (!this.config?.contentWrapperNode) {
-        this.__contentWrapperNode = document.createElement('div');
-      }
-      this.contentWrapperNode.setAttribute('data-id', 'content-wrapper');
-      // 'hack' that makes sure popperjs (that is applied one level lower) works correctly in deeply nested shadow roots
-      this.contentWrapperNode.style.transform = 'translateZ(0px)';
-
-      this.__rearrangeNodesCleanup = rearrangeNodes({
-        wrappingDialogNodeL1: wrappingDialogElement,
-        contentWrapperNodeL2: this.contentWrapperNode,
-        contentNodeL3: this.contentNode,
-        // requireConnectedNodes: Boolean(this.config.requireConnectedNodes),
-      });
-      wrappingDialogElement.open = true;
+    /**
+     * Based on the configuration of the developer, multiple scenarios are accounted for
+     * A. We already have a contentWrapperNode ()
+     */
+    if (!this.config?.contentWrapperNode) {
+      this.__contentWrapperNode = document.createElement('div');
+    }
+    this.contentWrapperNode.setAttribute('data-id', 'content-wrapper');
+    // 'hack' that makes sure popperjs (that is applied one level lower) works correctly in deeply nested shadow roots
+    this.contentWrapperNode.style.transform = 'translateZ(0px)';
 
-      if (this.isTooltip) {
-        // needed to prevent tooltip getting focus in Safari and Firefox
-        wrappingDialogElement.setAttribute('tabindex', '-1');
-      }
-      this.contentWrapperNode.style.zIndex = '1';
-      if (getComputedStyle(this.contentNode).position === 'absolute') {
-        // Having a _contWrapperNode and a contentNode with 'position:absolute' results in
-        // computed height of 0...
-        this.contentNode.style.position = 'static';
-      }
+    rearrangeNodes({
+      wrappingDialogNodeL1: wrappingDialogElement,
+      contentWrapperNodeL2: this.contentWrapperNode,
+      contentNodeL3: this.contentNode,
+    });
+    wrappingDialogElement.open = true;
 
-      // Here we prevent any interference of the native <dialog> element with the keyboard behavior
-      // as defined by the OverlayController. This is needed until we can configure `closedby="none"`
-      // on the native dialog for all browsers: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/dialog#closedby
-      const hasClosedBySupport = HTMLDialogElement && 'closedBy' in HTMLDialogElement.prototype;
-      if (hasClosedBySupport) {
-        // @ts-ignore - closedBy is a newer property not in all TypeScript versions
-        wrappingDialogElement.closedBy = 'none';
-      } else {
-        wrappingDialogElement.addEventListener(
-          'keydown',
-          (/** @type {* & KeyboardEvent} */ event) => {
-            if (event.key === 'Escape') {
-              event.preventDefault();
-            }
-          },
-        );
-        wrappingDialogElement.addEventListener(
-          'keyup',
-          (/** @type {* & KeyboardEvent} */ event) => {
-            if (event.key === 'Escape') {
-              event.preventDefault();
-            }
-          },
-        );
-        wrappingDialogElement.addEventListener('cancel', event => {
-          event.stopPropagation();
-        });
-        wrappingDialogElement.addEventListener('close', event => {
-          event.stopPropagation();
-        });
-      }
-    } else {
-      // quick hack to make none-popper/global flows work...
-      this.__contentWrapperNode = this.contentNode;
-      this.__wrappingDialogNode = this.contentNode;
+    if (this.isTooltip) {
+      // needed to prevent tooltip getting focus in Safari and Firefox
+      wrappingDialogElement.setAttribute('tabindex', '-1');
     }
-  }
 
-  __initVisibility() {
-    // TODO: allow defaultOpen?
-    /** @type {HTMLDialogElement} */ (this.__wrappingDialogNode).style.display = 'none';
-  }
+    this.__wrappingDialogNode.style.display = 'none';
+    this.contentWrapperNode.style.zIndex = '1';
+
+    if (getComputedStyle(this.contentNode).position === 'absolute') {
+      // Having a _contWrapperNode and a contentNode with 'position:absolute' results in
+      // computed height of 0...
+      this.contentNode.style.position = 'static';
+    }
 
-  // Clean up the DOM structure, leaving it as we found it.
-  // TODO: __teardownContentDomStructure method... use Resettable (rename ro Restorable) found in VisibilitToggleCtrl
-  __teardownVisibility() {
-    // TODO: full structure. For now we just reset display prop...
-    /** @type {HTMLDialogElement} */ (this.__wrappingDialogNode).style.display = '';
+    // Here we prevent any interference of the native <dialog> element with the keyboard behavior
+    // as defined by the OverlayController. This is needed until we can configure `closedby="none"`
+    // on the native dialog for all browsers: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/dialog#closedby
+    const hasClosedBySupport = HTMLDialogElement && 'closedBy' in HTMLDialogElement.prototype;
+    if (hasClosedBySupport) {
+      // @ts-expect-error
+      wrappingDialogElement.closedBy = 'none';
+    } else {
+      wrappingDialogElement.addEventListener(
+        'keydown',
+        (/** @type {* & KeyboardEvent} */ event) => {
+          if (event.key === 'Escape') {
+            event.preventDefault();
+          }
+        },
+      );
+      wrappingDialogElement.addEventListener('keyup', (/** @type {* & KeyboardEvent} */ event) => {
+        if (event.key === 'Escape') {
+          event.preventDefault();
+        }
+      });
+      wrappingDialogElement.addEventListener('cancel', event => {
+        event.stopPropagation();
+      });
+      wrappingDialogElement.addEventListener('close', event => {
+        event.stopPropagation();
+      });
+    }
   }
 
   /**
@@ -851,7 +742,6 @@ export class OverlayController extends EventTarget {
    * @private
    */
   __storeOriginalAttrs(node, attrs) {
-    /** @type {Record<string, string | null>} */
     const attrMap = {};
     attrs.forEach(attrName => {
       attrMap[attrName] = node.getAttribute(attrName);
@@ -908,7 +798,6 @@ export class OverlayController extends EventTarget {
       if ('HTMLDialogElement' in window && this.__wrappingDialogNode instanceof HTMLDialogElement) {
         this.__wrappingDialogNode.open = true;
       }
-
       // @ts-ignore
       this.__wrappingDialogNode.style.display = '';
       this._keepBodySize({ phase: 'before-show' });
@@ -922,14 +811,6 @@ export class OverlayController extends EventTarget {
         contentNode: this.contentNode,
       });
     }
-
-    // a styling/debug hook for open state
-    this.contentNode.setAttribute('data-open', '');
-
-    if (this.config.focusContentOnOpen) {
-      this.contentNode.focus();
-    }
-
     /** @type {function} */
     (this._showResolve)();
   }
@@ -962,7 +843,6 @@ export class OverlayController extends EventTarget {
       await this.__createPopperInstance();
       this._popper.forceUpdate();
     }
-    // N.B. leave it up to the user if placementMode === 'custom'
   }
 
   /**
@@ -970,7 +850,9 @@ export class OverlayController extends EventTarget {
    * @protected
    */
   _keepBodySize({ phase }) {
-    if (!this.preventsScroll) return;
+    if (!this.preventsScroll) {
+      return;
+    }
 
     this.manager.requestToKeepBodySize({ phase });
   }
@@ -980,9 +862,6 @@ export class OverlayController extends EventTarget {
    * @event hide right after the overlay is hidden
    */
   async hide() {
-    // Function like a no-op for dynamic edge cases...
-    if (!this.config.isOpenable) return;
-
     this._hideComplete = new Promise(resolve => {
       this._hideResolve = resolve;
     });
@@ -1015,6 +894,7 @@ export class OverlayController extends EventTarget {
       if ('HTMLDialogElement' in window && this.__wrappingDialogNode instanceof HTMLDialogElement) {
         this.__wrappingDialogNode.close();
       }
+
       // @ts-ignore
       this.__wrappingDialogNode.style.display = 'none';
       this._handleFeatures({ phase: 'hide' });
@@ -1023,8 +903,6 @@ export class OverlayController extends EventTarget {
       this._restoreFocus();
     }
     /** @type {function} */ (this._hideResolve)();
-
-    this.contentNode.removeAttribute('data-open');
   }
 
   /**
@@ -1135,24 +1013,23 @@ export class OverlayController extends EventTarget {
     if (this.visibilityTriggerFunction) {
       this._handleVisibilityTriggers({ phase });
     }
-
-    if (phase === 'init' && this.config.focusContentOnOpen) {
-      this.contentNode?.setAttribute('tabindex', '-1');
-    }
-
-    if (phase === 'teardown' && this.config.focusContentOnOpen) {
-      // TODO: capture initial attr, use Resettable mechanism of VisibilityToggleCtrl in whole Controller
-      this.contentNode?.removeAttribute('tabindex');
-    }
   }
 
   /**
    * @param {{ phase: OverlayPhase }} config
    */
   _handleVisibilityTriggers({ phase }) {
-    if (typeof this.visibilityTriggerFunction !== 'function') return;
-
-    this.visibilityTriggerFunction({ controller: this })?.[phase]?.();
+    if (typeof this.visibilityTriggerFunction === 'function') {
+      if (phase === 'init') {
+        this.__visibilityTriggerHandler = this.visibilityTriggerFunction({
+          phase,
+          controller: this,
+        });
+      }
+      if (this.__visibilityTriggerHandler[phase]) {
+        this.__visibilityTriggerHandler[phase]();
+      }
+    }
   }
 
   /**
@@ -1309,9 +1186,7 @@ export class OverlayController extends EventTarget {
     if (phase === 'show') {
       this.#handleShiftKeyPress();
       this.#handleFocusInsideDialog();
-      // @ts-ignore - HTMLDialogElement methods
       this.__wrappingDialogNode?.close();
-      // @ts-ignore - HTMLDialogElement methods
       this.__wrappingDialogNode?.showModal();
       /**
        * At this moment `#handleFocusInsideDialog` should handle the focus.
@@ -1562,7 +1437,6 @@ export class OverlayController extends EventTarget {
   }
 
   teardown() {
-    if (!this.#hasSetup) return;
     this.__handleOverlayStyles({ phase: 'teardown' });
     if (this.isShown) {
       this._keepBodySize({ phase: 'teardown' });
@@ -1571,13 +1445,6 @@ export class OverlayController extends EventTarget {
     if (this.#isRegisteredOnManager()) {
       this.manager.remove(this);
     }
-
-    this.contentNode?.removeEventListener('click', this.#hideOnCloseButtonClick);
-
-    this.__rearrangeNodesCleanup?.();
-    this.__teardownVisibility();
-
-    this.#hasSetup = false;
   }
 
   /** @private */