@vonage/vivid 4.23.0 → 4.25.0

package/shared/definition31.cjs

@@ -1,13 +1,18 @@
 'use strict';
 
-const definition = require('./definition28.cjs');
+const definition$1 = require('./definition67.cjs');
+const definition = require('./definition30.cjs');
 const vividElement = require('./vivid-element.cjs');
-const affix = require('./affix.cjs');
+const anchored = require('./anchored.cjs');
 const delegatesAria = require('./delegates-aria.cjs');
+const divider = require('./divider.cjs');
+const keyCodes = require('./key-codes.cjs');
+const index = require('./index.cjs');
 const ref = require('./ref.cjs');
 const classNames = require('./class-names.cjs');
+const slotted = require('./slotted.cjs');
 
-const styles = ".control.connotation-cta{--_connotation-color-primary: var(--vvd-nav-disclosure-cta-primary, var(--vvd-color-cta-500));--_connotation-color-primary-text: var(--vvd-nav-disclosure-cta-primary-text, var(--vvd-color-canvas));--_connotation-color-primary-increment: var(--vvd-nav-disclosure-cta-primary-increment, var(--vvd-color-cta-600));--_connotation-color-contrast: var(--vvd-nav-disclosure-cta-contrast, var(--vvd-color-cta-800));--_connotation-color-fierce: var(--vvd-nav-disclosure-cta-fierce, var(--vvd-color-cta-700));--_connotation-color-fierce-primary: var(--vvd-nav-disclosure-cta-fierce-primary, var(--vvd-color-cta-700));--_connotation-color-faint: var(--vvd-nav-disclosure-cta-faint, var(--vvd-color-cta-50));--_connotation-color-firm: var(--vvd-nav-disclosure-cta-firm, var(--vvd-color-cta-600));--_connotation-color-soft: var(--vvd-nav-disclosure-cta-soft, var(--vvd-color-cta-100))}.control:not(.connotation-cta){--_connotation-color-primary: var(--vvd-nav-disclosure-accent-primary, var(--vvd-color-canvas-text));--_connotation-color-primary-text: var(--vvd-nav-disclosure-accent-primary-text, var(--vvd-color-canvas));--_connotation-color-primary-increment: var(--vvd-nav-disclosure-accent-primary-increment, var(--vvd-color-neutral-800));--_connotation-color-contrast: var(--vvd-nav-disclosure-accent-contrast, var(--vvd-color-neutral-800));--_connotation-color-fierce: var(--vvd-nav-disclosure-accent-fierce, var(--vvd-color-neutral-700));--_connotation-color-fierce-primary: var(--vvd-nav-disclosure-accent-fierce-primary, var(--vvd-color-canvas-text));--_connotation-color-faint: var(--vvd-nav-disclosure-accent-faint, var(--vvd-color-neutral-50));--_connotation-color-firm: var(--vvd-nav-disclosure-accent-firm, var(--vvd-color-canvas-text));--_connotation-color-soft: var(--vvd-nav-disclosure-accent-soft, var(--vvd-color-neutral-100))}.control,.control.appearance-ghost-light{--_appearance-color-text: var(--_connotation-color-firm);--_appearance-color-fill: transparent;--_appearance-color-outline: transparent}.control:where(.hover,:hover):where(:not(.disabled,:disabled,.readonly)){--_appearance-color-text: var(--_connotation-color-firm);--_appearance-color-fill: var(--_connotation-color-faint);--_appearance-color-outline: transparent}.control:where(.hover,:hover):where(:not(.disabled,:disabled,.readonly)).appearance-ghost-light{--_appearance-color-text: var(--_connotation-color-fierce-primary);--_appearance-color-fill: color-mix(in srgb, var(--_connotation-color-primary), transparent 90%);--_appearance-color-outline: transparent}.control:where(.active,:active):where(:not(.disabled,:disabled)){--_appearance-color-text: var(--_connotation-color-firm);--_appearance-color-fill: var(--_connotation-color-soft);--_appearance-color-outline: transparent}.control:where(.active,:active):where(:not(.disabled,:disabled)).appearance-ghost-light{--_appearance-color-text: var(--_connotation-color-fierce-primary);--_appearance-color-fill: color-mix(in srgb, var(--_connotation-color-primary), transparent 80%);--_appearance-color-outline: transparent}.control:where([aria-current]):where(:not(.disabled,:disabled)){--_appearance-color-text: var(--_connotation-color-primary-text);--_appearance-color-fill: var(--_connotation-color-primary);--_appearance-color-outline: transparent}.control:where([aria-current]):where(:not(.disabled,:disabled)).appearance-ghost-light{--_appearance-color-text: var(--_connotation-color-primary-text);--_appearance-color-fill: color-mix(in srgb, var(--_connotation-color-firm), transparent 10%);--_appearance-color-outline: transparent}.control:where([aria-current]):where(.hover,:hover):where(:not(.disabled,:disabled,.readonly)){--_appearance-color-text: var(--_connotation-color-primary-text);--_appearance-color-fill: var(--_connotation-color-primary-increment);--_appearance-color-outline: transparent}.control:where([aria-current]):where(.hover,:hover):where(:not(.disabled,:disabled,.readonly)).appearance-ghost-light{--_appearance-color-text: var(--_connotation-color-primary-text);--_appearance-color-fill: color-mix(in srgb, var(--_connotation-color-fierce-primary), transparent 20%);--_appearance-color-outline: transparent}.control{display:flex;box-sizing:border-box;align-items:center;border-radius:8px;background-color:var(--_appearance-color-fill);box-shadow:inset 0 0 0 1px var(--_appearance-color-outline);cursor:pointer;font:var(--vvd-typography-base);gap:12px;hyphens:auto;inline-size:100%;min-block-size:calc(1px*(40 + 4*clamp(-1,var(--vvd-size-density, 0),2)));padding-block:10px;padding-inline:16px;text-decoration:none;vertical-align:middle}.control[aria-current]{color:var(--_appearance-color-text)}@supports not (color: color-mix(in srgb,var(--one-color),var(--second-color))){.control[aria-current]{background-color:var(--_connotation-color-primary)}}.control:not([aria-current]){color:var(--vvd-color-canvas-text)}.control:focus-visible{box-shadow:0 0 0 4px color-mix(in srgb,var(--vvd-color-cta-500),transparent 85%),inset 0 0 0 3px var(--focus-stroke-gap-color, currentColor);outline:1px solid var(--focus-stroke-color, var(--vvd-color-cta-500));outline-offset:calc(-1px - var(--focus-inset, 0px))}:host(:where([aria-current=true][open])) .control,:host(:not([aria-current=true])) .control{--focus-stroke-gap-color: transparent}@supports (user-select: none){.control{user-select:none}}.control .toggleIcon{margin-inline-start:auto}slot[name=icon]{font-size:20px;line-height:1}.content{display:flex;flex-direction:column;border-inline-start:1px solid var(--vvd-color-neutral-200);gap:4px;margin-block:4px;margin-inline-start:20px;padding-inline-start:12px}details>summary{list-style:none}details>summary::-webkit-details-marker{display:none}";
+const styles = ":host{display:var(--_popup-display, inline)}:host([slotted-anchor]){--_popup-display: contents}.base{display:flex;overflow:hidden auto;box-sizing:border-box;flex-direction:column;gap:8px;inline-size:max-content;max-block-size:var(--menu-block-size, 408px);min-inline-size:var(--menu-min-inline-size);padding-block:8px}@media not all and (width >= 600px){.base{max-inline-size:var(--menu-max-inline-size, 300px)}}@media (width >= 600px){.base{max-inline-size:var(--menu-max-inline-size)}}::slotted(a){color:var(--vvd-color-canvas-text);text-decoration:none}::slotted(a[role=menuitem]:focus-visible){box-shadow:0 0 0 4px color-mix(in srgb,var(--vvd-color-cta-500),transparent 85%),inset 0 0 0 3px var(--focus-stroke-gap-color, currentColor);outline:1px solid var(--focus-stroke-color, var(--vvd-color-cta-500));outline-offset:calc(-1px - var(--focus-inset, 0px));--focus-stroke-gap-color: transparent;display:block}.header{padding-block-start:4px;padding-inline:12px}.hide-header .header{display:none}.body{display:flex;flex-direction:column;row-gap:1px}.hide-body .body{display:none}.action-items{display:flex;justify-content:flex-end;gap:8px;padding-block-end:4px;padding-inline:12px}.hide-actions .action-items{display:none}";
 
 var __defProp = Object.defineProperty;
 var __decorateClass = (decorators, target, key, kind) => {
@@ -18,91 +23,363 @@ var __decorateClass = (decorators, target, key, kind) => {
   if (result) __defProp(target, key, result);
   return result;
 };
-class NavDisclosure extends affix.AffixIcon(delegatesAria.DelegatesAria(vividElement.VividElement)) {
+const isCheckbox = (el) => el instanceof definition.MenuItem && el.controlType === "checkbox";
+const isRadio = (el) => el instanceof definition.MenuItem && el.controlType === "radio";
+const isSeparator = (el) => el instanceof divider.Divider ? true : el.role === "separator";
+const isMenuItemElement = (el) => el instanceof definition.MenuItem ? true : Boolean(el.role && el.role in definition.MenuItemRole);
+class Menu extends anchored.Anchored(delegatesAria.DelegatesAria(vividElement.VividElement)) {
   constructor() {
     super(...arguments);
+    this.expandedItem = null;
+    /**
+     * The index of the focusable element in the items array
+     * defaults to -1
+     */
+    this.focusIndex = -1;
+    /**
+     * if focus is moving out of the menu, reset to a stable initial state
+     * @internal
+     */
+    this.handleFocusOut = (e) => {
+      if (!this.contains(e.relatedTarget) && this.menuItems !== void 0 && this.menuItems.length) {
+        this.collapseExpandedItem();
+        this.menuItems[this.focusIndex].setAttribute("tabindex", "-1");
+        this.menuItems[0].setAttribute("tabindex", "0");
+        this.focusIndex = 0;
+      }
+    };
+    this.handleItemFocus = (e) => {
+      const targetItem = e.target;
+      if (this.menuItems !== void 0 && targetItem !== this.menuItems[this.focusIndex]) {
+        this.menuItems[this.focusIndex].setAttribute("tabindex", "-1");
+        this.focusIndex = this.menuItems.indexOf(targetItem);
+        targetItem.setAttribute("tabindex", "0");
+      }
+    };
+    this.handleExpandedChanged = (e) => {
+      const changedItem = e.target;
+      if (this.expandedItem !== null && changedItem === this.expandedItem && changedItem.expanded === false) {
+        this.expandedItem = null;
+      }
+      if (changedItem.expanded) {
+        this.expandedItem = changedItem;
+      }
+    };
+    this.removeItemListeners = () => {
+      if (this.menuItems !== void 0) {
+        this.menuItems.forEach((item) => {
+          item.removeEventListener("expanded-change", this.handleExpandedChanged);
+          item.removeEventListener(
+            "focus",
+            this.handleItemFocus
+          );
+        });
+      }
+    };
+    this.setItems = () => {
+      const newItems = this.domChildren();
+      this.removeItemListeners();
+      this.menuItems = newItems.filter(isMenuItemElement);
+      if (this.menuItems.length) {
+        this.focusIndex = 0;
+      }
+      this.menuItems.forEach((item, index) => {
+        if (item instanceof definition.MenuItem) {
+          item._isPresentational = false;
+        }
+        item.setAttribute("tabindex", index === 0 ? "0" : "-1");
+        item.addEventListener("expanded-change", this.handleExpandedChanged);
+        item.addEventListener("focus", this.handleItemFocus);
+      });
+    };
+    this.placement = "bottom";
+    this.autoDismiss = false;
+    this.positionStrategy = "fixed";
     this.open = false;
-    this.#onToggle = () => {
-      this.open = this.details.open;
-      this.$emit("toggle", void 0, { bubbles: false });
+    this.#onAnchorClick = () => {
+      if (this.#triggerBehaviour === "off") {
+        return;
+      }
+      if (this.#triggerBehaviour === "legacy" && this.open) {
+        return;
+      }
+      const newValue = !this.open;
+      vividElement.DOM.queueUpdate(() => this.open = newValue);
+    };
+    this._onFocusout = (e) => {
+      const focusTarget = e.relatedTarget;
+      const focusMovedAway = !this.contains(focusTarget) && !this._anchorEl?.contains(focusTarget);
+      if (this.autoDismiss && focusMovedAway) {
+        this.open = false;
+      }
     };
   }
+  /**
+   * @internal
+   */
+  itemsChanged() {
+    if (this.$fastController.isConnected && this.menuItems !== void 0) {
+      this.setItems();
+    }
+  }
   /**
    * @internal
    */
   connectedCallback() {
     super.connectedCallback();
-    this.details.addEventListener("toggle", this.#onToggle);
-    this.details.open = this.open;
+    vividElement.DOM.queueUpdate(() => {
+      this.setItems();
+    });
   }
   /**
    * @internal
    */
   disconnectedCallback() {
     super.disconnectedCallback();
-    this.details.removeEventListener("toggle", this.#onToggle);
+    this.removeItemListeners();
+    this.menuItems = void 0;
+  }
+  /**
+   * Moves focus into the menu. If there is a child with the `autofocus` attribute, it will be focused.
+   * Otherwise, the first focusable child will be focused.
+   *
+   * @public
+   */
+  focus() {
+    const autoFocusElement = this.querySelector(
+      '[autofocus]:not([slot="anchor"])'
+    );
+    if (autoFocusElement instanceof HTMLElement) {
+      autoFocusElement.focus();
+    } else {
+      this.setFocus(0);
+    }
+  }
+  /**
+   * Collapses any expanded Menu Items.
+   *
+   * @public
+   */
+  collapseExpandedItem() {
+    if (this.expandedItem !== null) {
+      this.expandedItem.expanded = false;
+      this.expandedItem = null;
+    }
+  }
+  /**
+   * @internal
+   */
+  handleMenuKeyDown(e) {
+    if (e.defaultPrevented || this.menuItems === void 0) {
+      return;
+    }
+    switch (e.key) {
+      case keyCodes.keyArrowDown:
+        this.setFocus(this.focusIndex + 1);
+        return;
+      case keyCodes.keyArrowUp:
+        this.setFocus(this.focusIndex - 1);
+        return;
+      case keyCodes.keyEnd:
+        this.setFocus(this.menuItems.length - 1);
+        return;
+      case keyCodes.keyHome:
+        this.setFocus(0);
+        return;
+      default:
+        return true;
+    }
+  }
+  /**
+   * get an array of valid DOM children
+   */
+  domChildren() {
+    return Array.from(this.children).filter((child) => !child.hasAttribute("hidden")).filter((child) => !child.hasAttribute("slot"));
+  }
+  setFocus(focusIndex) {
+    if (this.menuItems === void 0) {
+      return;
+    }
+    if (focusIndex >= 0 && focusIndex < this.menuItems.length) {
+      const child = this.menuItems[focusIndex];
+      if (this.focusIndex > -1 && this.menuItems.length >= this.focusIndex - 1) {
+        this.menuItems[this.focusIndex].setAttribute("tabindex", "-1");
+      }
+      this.focusIndex = focusIndex;
+      child.setAttribute("tabindex", "0");
+      child.focus();
+    }
+  }
+  get #triggerBehaviour() {
+    return this.trigger ?? "legacy";
+  }
+  openChanged(_, newValue) {
+    if (newValue) {
+      this._popupEl?.show().then(() => this.focus());
+    }
+    newValue ? this.$emit("open", void 0, { bubbles: false }) : this.$emit("close", void 0, { bubbles: false });
+    if (this._anchorEl) {
+      this.#updateAnchor(this._anchorEl);
+    }
+  }
+  /**
+   * @internal
+   */
+  _anchorElChanged(oldValue, newValue) {
+    if (oldValue) this.#cleanupAnchor(oldValue);
+    if (newValue) this.#setupAnchor(newValue);
+  }
+  #setupAnchor(a) {
+    a.addEventListener("click", this.#onAnchorClick, true);
+    a.addEventListener("focusout", this._onFocusout);
+    a.setAttribute("aria-haspopup", "menu");
+    this.#updateAnchor(a);
+  }
+  #updateAnchor(a) {
+    a.setAttribute("aria-expanded", this.open.toString());
+    a.setAttribute("data-expanded", this.open.toString());
+  }
+  #cleanupAnchor(a) {
+    a.removeEventListener("click", this.#onAnchorClick, true);
+    a.removeEventListener("focusout", this._onFocusout);
+    a.removeAttribute("aria-haspopup");
+    a.removeAttribute("aria-expanded");
+    a.removeAttribute("data-expanded");
+  }
+  #onAnchorClick;
+  /**
+   * @internal
+   */
+  _onChange(e) {
+    if (this.menuItems === void 0 || !(e.target instanceof Element)) {
+      return;
+    }
+    if (this.#triggerBehaviour === "auto" && !isCheckbox(e.target)) {
+      this.open = false;
+    }
+    const domChildren = this.domChildren();
+    const targetItemIndex = domChildren.indexOf(e.target);
+    if (targetItemIndex === -1) {
+      return;
+    }
+    if (isRadio(e.target) && e.target.checked) {
+      for (let i = targetItemIndex - 1; i >= 0; --i) {
+        const item = domChildren[i];
+        if (isRadio(item)) {
+          item.checked = false;
+        }
+        if (isSeparator(item)) {
+          break;
+        }
+      }
+      for (let i = targetItemIndex + 1; i <= domChildren.length - 1; ++i) {
+        const item = domChildren[i];
+        if (isRadio(item)) {
+          item.checked = false;
+        }
+        if (isSeparator(item)) {
+          break;
+        }
+      }
+    }
+    return true;
   }
-  #onToggle;
 }
 __decorateClass([
-  vividElement.attr
-], NavDisclosure.prototype, "label");
+  vividElement.observable
+], Menu.prototype, "items");
 __decorateClass([
-  vividElement.attr
-], NavDisclosure.prototype, "appearance");
+  vividElement.attr({ mode: "fromView" })
+], Menu.prototype, "placement");
 __decorateClass([
   vividElement.attr
-], NavDisclosure.prototype, "connotation");
+], Menu.prototype, "trigger");
+__decorateClass([
+  vividElement.attr({ mode: "boolean", attribute: "auto-dismiss" })
+], Menu.prototype, "autoDismiss");
+__decorateClass([
+  vividElement.attr({ mode: "fromView", attribute: "position-strategy" })
+], Menu.prototype, "positionStrategy");
 __decorateClass([
   vividElement.attr({ mode: "boolean" })
-], NavDisclosure.prototype, "open");
+], Menu.prototype, "open");
+__decorateClass([
+  vividElement.observable
+], Menu.prototype, "headerSlottedContent");
+__decorateClass([
+  vividElement.observable
+], Menu.prototype, "actionItemsSlottedContent");
 
-function getAriaCurrent(ariaCurrent, open) {
-  return open ? null : ariaCurrent;
-}
-const getClasses = ({ appearance, connotation }) => classNames.classNames(
-  "control",
-  [`appearance-${appearance}`, Boolean(appearance)],
-  [`connotation-${connotation}`, Boolean(connotation)]
+const getClasses = ({
+  headerSlottedContent,
+  actionItemsSlottedContent,
+  items
+}) => classNames.classNames(
+  "base",
+  ["hide-header", !headerSlottedContent?.length],
+  ["hide-actions", !actionItemsSlottedContent?.length],
+  ["hide-body", items && !items.length]
 );
-const NavDisclosureTemplate = (context) => {
-  const affixIconTemplate = affix.affixIconTemplateFactory(context);
-  const iconTag = context.tagFor(definition.Icon);
-  return vividElement.html`<details class="base" ${ref.ref("details")} ?open=${(x) => x.open}>
-		<summary class="${getClasses}"
-						 aria-controls="disclosure-content"
-						 ${delegatesAria.delegateAria({
-    role: "button",
-    ariaExpanded: (x) => x.open,
-    ariaCurrent: (x) => getAriaCurrent(x.ariaCurrent, x.open)
+function handleEscapeKey(menu, event) {
+  if (menu.open && index.handleEscapeKeyAndStopPropogation(event)) {
+    menu.open = false;
+  }
+  return true;
+}
+const MenuTemplate = (context) => {
+  const popupTag = context.tagFor(definition$1.Popup);
+  const anchorSlotTemplate = anchored.anchorSlotTemplateFactory();
+  function handlePopupEvents(x, e, state) {
+    e.stopPropagation();
+    x.open = state;
+  }
+  return vividElement.html`
+		<template @change="${(x, c) => x._onChange(c.event)}"
+							@focusout="${(x, c) => x._onFocusout(c.event)}">
+			${anchorSlotTemplate}
+			<${popupTag}
+				${ref.ref("_popupEl")}
+				:placement=${(x) => x.placement}
+				:open=${(x) => x.open}
+				:anchor=${(x) => x._anchorEl}
+				:strategy="${(x) => x.positionStrategy}"
+				@keydown="${(x, c) => handleEscapeKey(x, c.event)}"
+				@vwc-popup:open="${(x, c) => handlePopupEvents(x, c.event, true)}"
+				@vwc-popup:close="${(x, c) => handlePopupEvents(x, c.event, false)}"
+			>
+			<div class="${getClasses}">
+				<div class="header">
+					<slot name="header" ${slotted.slotted("headerSlottedContent")}></slot>
+				</div>
+				<div
+					class="body"
+					${delegatesAria.delegateAria({
+    role: "menu"
   })}
-		>
-			${(x) => affixIconTemplate(x.icon, affix.IconWrapper.Slot)}
-			${(x) => x.label}
-			<slot name="meta"></slot>
-			<${iconTag} class="toggleIcon" name=${(x) => x.open ? "chevron-up-solid" : "chevron-down-solid"}
-									aria-hidden="true"></${iconTag}>
-		</summary>
-		<div class="content" id="disclosure-content">
-			<slot></slot>
-		</div>
-	</details>
-	`;
+					@keydown="${(x, c) => x.handleMenuKeyDown(c.event)}"
+					@focusout="${(x, c) => x.handleFocusOut(c.event)}"
+				>
+					<slot ${slotted.slotted("items")}></slot>
+				</div>
+				<footer class="action-items"><slot name="action-items"  ${slotted.slotted(
+    "actionItemsSlottedContent"
+  )}></slot></footer>
+			</div>
+		</${popupTag}>
+	</template>`;
 };
 
-const navDisclosureDefinition = vividElement.defineVividComponent(
-  "nav-disclosure",
-  NavDisclosure,
-  NavDisclosureTemplate,
-  [definition.iconDefinition],
+const menuDefinition = vividElement.defineVividComponent(
+  definition.menuName,
+  Menu,
+  MenuTemplate,
+  [definition$1.popupDefinition, definition.menuItemDefinition],
   {
     styles
   }
 );
-const registerNavDisclosure = vividElement.createRegisterFunction(
-  navDisclosureDefinition
-);
+const registerMenu = vividElement.createRegisterFunction(menuDefinition);
 
-exports.NavDisclosure = NavDisclosure;
-exports.navDisclosureDefinition = navDisclosureDefinition;
-exports.registerNavDisclosure = registerNavDisclosure;
+exports.Menu = Menu;
+exports.menuDefinition = menuDefinition;
+exports.registerMenu = registerMenu;