@mgdis/mg-components 5.4.0 → 5.6.0

package/dist/collection/components/molecules/menu/mg-menu-item/mg-menu-item.js

@@ -1,7 +1,9 @@
 import { h, Host } from '@stencil/core';
+import { OverflowBehaviorElements } from '../../../../utils/behaviors.utils';
 import { ClassList } from '../../../../utils/components.utils';
+import { initLocales } from '../../../../locales';
 import { Direction } from '../mg-menu/mg-menu.conf';
-import { sizes, Status } from './mg-menu-item.conf';
+import { Status } from './mg-menu-item.conf';
 export class MgMenuItem {
   constructor() {
     /************
@@ -9,32 +11,9 @@ export class MgMenuItem {
      ************/
     this.name = 'mg-menu-item';
     this.navigationButton = `${this.name}__navigation-button`;
-    /**
-     * Define menu-item status. Default: "visible"
-     */
-    this.status = Status.VISIBLE;
-    /**
-     * Define menu-item size. Default: "large".
-     */
-    this.size = 'large';
-    /**
-     * Define menu-item content expanded. Default: false.
-     */
-    this.expanded = false;
-    /************
-     * States *
-     ************/
-    /**
-     * Component button classes
-     */
-    this.navigationButtonClassList = new ClassList([this.navigationButton]);
-    /**
-     * Does component have children. Default: false.
-     */
-    this.hasChildren = false;
-    /************
+    /***********
      * Methods *
-     ************/
+     **********/
     /**
      * Toggle expanded prop value
      *
@@ -44,20 +23,20 @@ export class MgMenuItem {
       this.expanded = !this.expanded;
     };
     /**
-     * Does an HTMLElement contain child with given Status
+     * Does an Element have given Status
      *
-     * @param {HTMLElement} element to parse
+     * @param {Element} element to parse
      * @param {MgMenuItem['status']} status to check
      * @returns {boolean} true if element with status is found
      */
-    this.hasChildElementStatus = (element, status) => element.querySelector(`${this.name}[status="${status}"]`) !== null;
+    this.hasStatus = (element, status) => element.querySelector(`${this.name}[status="${status}"]`) !== null;
     /**
      * Is component contextual direction match the given direction
      *
      * @param {MgMenuItem['direction']} direction in parent menu
      * @returns {boolean} true is direction match the direction propertie
      */
-    this.isdirection = (direction) => this.direction === direction;
+    this.isDirection = (direction) => this.direction === direction;
     /************
      * Handlers *
      ************/
@@ -68,23 +47,57 @@ export class MgMenuItem {
      * @returns {void}
      */
     this.handleElementCLick = (event) => {
-      event.preventDefault();
+      if ((this.hasChildren && !this.isInMainMenu) || this.status === Status.DISABLED) {
+        event.preventDefault();
+        event.stopPropagation();
+      }
+      // toggle expanded when mg-menu-item has child items
       if (this.hasChildren)
         this.toggleExpanded();
     };
+    /**
+     * Handle popover element display-change event
+     *
+     * @param {CustomEvent} event popover display event
+     * @returns {void}
+     */
+    this.handlePopoverDisplay = (event) => {
+      this.expanded = event.detail;
+    };
+    /**
+     * Update displayNotificationBadge
+     * current component notification badge have priority over the slot badge when submenu contain badge
+     *
+     * @returns {void} update displayNotificationBadge value
+     */
+    this.updateDisplayNotificationBadge = () => {
+      const childMenu = this.element.querySelector('mg-menu');
+      this.displayNotificationBadge =
+        childMenu !== null &&
+          Array.from(childMenu.children).some((subItem) => subItem.querySelector('mg-badge') !== null && subItem.getAttribute('hidden') === null);
+    };
+    /**
+     * Render slot
+     *
+     * @returns {HTMLElement} HTML Element
+     */
+    this.renderSlot = () => h("slot", null);
+    this.href = undefined;
+    this.status = Status.VISIBLE;
+    this.expanded = false;
+    this.size = 'regular';
+    this.navigationButtonClassList = new ClassList([this.navigationButton]);
+    this.direction = undefined;
+    this.isInMainMenu = undefined;
+    this.hasChildren = false;
+    this.displayNotificationBadge = undefined;
   }
   validateStatus(newValue, oldValue) {
     if (oldValue !== undefined) {
       this.navigationButtonClassList.delete(`${this.navigationButton}--${oldValue}`);
     }
     this.navigationButtonClassList.add(`${this.navigationButton}--${newValue}`);
-  }
-  validateSize(newValue, oldValue) {
-    if (!sizes.includes(newValue)) {
-      throw new Error(`<${this.name}> prop "size" must be one of : ${sizes.join(', ')}.`);
-    }
-    this.navigationButtonClassList.delete(`${this.navigationButton}--size-${oldValue}`);
-    this.navigationButtonClassList.add(`${this.navigationButton}--size-${newValue}`);
+    this.statusChange.emit(newValue);
   }
   validateExpanded(newValue) {
     if (typeof newValue !== 'boolean')
@@ -98,16 +111,20 @@ export class MgMenuItem {
           item.expanded = false;
         });
       }
-      else if (newValue && this.hasChildElementStatus(this.element, Status.ACTIVE)) {
+      else if (this.hasStatus(this.element, Status.ACTIVE)) {
         // - when expanded and contain an active item parents are expended too
         subItems.forEach(item => {
-          if (this.hasChildElementStatus(item, Status.ACTIVE)) {
+          if (this.hasStatus(item, Status.ACTIVE)) {
             item.expanded = true;
           }
         });
       }
     }
   }
+  validateSize(newValue, oldValue) {
+    this.navigationButtonClassList.delete(`${this.navigationButton}--size-${oldValue}`);
+    this.navigationButtonClassList.add(`${this.navigationButton}--size-${newValue}`);
+  }
   validateHasChildren(newValue) {
     if (newValue && this.element.href !== undefined) {
       throw new Error(`<${this.name}> prop "href" is unauthorizied when element is a parent.`);
@@ -122,13 +139,14 @@ export class MgMenuItem {
    * @returns {void}
    */
   componentWillLoad() {
-    // has children items that is NOT [slot="illustration"] || [slot="information"] element
+    // has children items that is NOT [slot='image' | 'information' | 'label' | 'metadata'] element
     // we store only matching elements
-    this.hasChildren = Array.from(this.element.children).filter(child => !['illustration', 'information', 'label', 'metadata'].includes(child.getAttribute('slot'))).length > 0;
+    this.hasChildren = Array.from(this.element.children).some(child => !['image', 'information', 'label', 'metadata'].includes(child.getAttribute('slot')));
     // Validate props
     this.validateSize(this.size);
     this.validateStatus(this.status);
     this.validateExpanded(this.expanded);
+    this.badgeLabel = initLocales(this.element).messages.plusMenu.badgeLabel;
   }
   /**
    * Check if component slots configuration
@@ -152,49 +170,67 @@ export class MgMenuItem {
     // return a promise to process action only in the FIRST render().
     // https://stenciljs.com/docs/component-lifecycle#componentwillload
     return setTimeout(() => {
-      var _a, _b;
+      var _a;
       // define menu-item context states
-      if (this.element.parentElement.nodeName === 'MG-MENU') {
-        this.direction = this.element.parentElement.direction;
-      }
-      this.isInMainMenu = this.element.parentElement.className.includes('mg-menu-item') === false;
-      const hasNextMenuItem = ((_a = this.element.nextElementSibling) === null || _a === void 0 ? void 0 : _a.nodeName) === 'MG-MENU-ITEM';
-      const hasPreviousMenuItem = ((_b = this.element.previousElementSibling) === null || _b === void 0 ? void 0 : _b.nodeName) === 'MG-MENU-ITEM';
-      // manage last menu item
-      if (!hasNextMenuItem && hasPreviousMenuItem && this.isdirection(Direction.HORIZONTAL)) {
-        this.element.setAttribute('data-style-position-last', '');
-      }
+      const menu = this.element.closest('mg-menu');
+      this.direction = this.element.getAttribute(OverflowBehaviorElements.MORE) !== null || menu === null ? Direction.HORIZONTAL : menu.direction;
+      this.size = menu === null || menu === void 0 ? void 0 : menu.size;
+      this.isInMainMenu = this.element.parentElement.closest('mg-menu-item') === null;
       // when main menu item contain an active item it will get the active style
       // AND if item is in vertical menu it will be expanded
-      if (this.isInMainMenu && this.hasChildElementStatus(this.element, Status.ACTIVE)) {
+      const hasActiveChild = Array.from(this.element.children).some(element => this.hasStatus(element, Status.ACTIVE) && element.getAttribute('hidden') === null);
+      if (this.isInMainMenu && hasActiveChild) {
         this.status = Status.ACTIVE;
-        this.expanded = this.direction === Direction.VERTICAL;
+        this.expanded = this.isDirection(Direction.VERTICAL);
       }
       // manage menu items style depending to parent menu horientation
       this.element.setAttribute(`data-style-direction-${this.direction}`, '');
       this.navigationButtonClassList.add(`${this.navigationButton}--${this.direction}`);
-      // manage child items level
-      const childItems = Array.from(this.element.querySelectorAll('mg-menu-item'));
-      childItems.forEach(item => {
-        if (this.direction === Direction.VERTICAL) {
+      this.updateDisplayNotificationBadge();
+      // manage all sub levels child menu-items level with data-level attribut
+      if (this.isDirection(Direction.VERTICAL)) {
+        Array.from(this.element.querySelectorAll('mg-menu-item')).forEach(item => {
           const itemLevel = Number(item.getAttribute('data-level')) || 1;
           item.setAttribute('data-level', `${itemLevel + 1}`);
-        }
+        });
+      }
+      // manage first sub-level menu-items
+      const childItems = Array.from(((_a = this.element.querySelector('mg-menu')) === null || _a === void 0 ? void 0 : _a.children) || []).filter(item => item.nodeName === 'MG-MENU-ITEM');
+      childItems.forEach(item => {
+        // manage child menu listener
+        new MutationObserver(() => {
+          this.updateDisplayNotificationBadge();
+        }).observe(item, { attributes: true });
       });
     }, 0);
   }
   /**
-   * Render
+   * Render ineractive element
    *
    * @returns {HTMLElement} HTML Element
    */
-  render() {
+  renderInteractiveElement() {
     const TagName = this.href !== undefined ? 'a' : 'button';
-    return (h(Host, { role: "menuitem", "aria-haspopup": this.hasChildren.toString() }, h(TagName, { href: this.href, class: this.navigationButtonClassList.join(), tabindex: [Status.DISABLED, Status.HIDDEN].includes(this.status) ? -1 : 0, disabled: this.status === Status.DISABLED, "aria-expanded": this.hasChildren && this.expanded.toString(), "aria-current": this.status === Status.ACTIVE && 'page', onClick: this.handleElementCLick }, h("slot", { name: "illustration" }), h("div", { class: `${this.navigationButton}-center` }, h("div", { class: `${this.navigationButton}-text-content` }, h("slot", { name: "label" }), h("slot", { name: "information" })), h("slot", { name: "metadata" })), this.hasChildren && this.href === undefined && (h("span", { class: {
+    return (h(TagName, { href: this.href, class: this.navigationButtonClassList.join(), tabindex: [Status.DISABLED, Status.HIDDEN].includes(this.status) ? -1 : 0, disabled: this.status === Status.DISABLED, hidden: this.status === Status.HIDDEN, "aria-expanded": this.hasChildren && this.expanded.toString(), "aria-current": this.status === Status.ACTIVE && 'page', onClick: this.handleElementCLick }, h("slot", { name: "image" }), h("div", { class: `${this.navigationButton}-center` }, h("div", { class: `${this.navigationButton}-text-content` }, h("slot", { name: "label" }), !this.displayNotificationBadge && h("slot", { name: "information" }), this.displayNotificationBadge && (h("span", { class: "mg-menu-item__navigation-button-text-content-notification" }, h("mg-badge", { label: this.badgeLabel, value: "!", variant: "info", slot: "information" })))), this.size !== 'regular' && h("slot", { name: "metadata" })), this.hasChildren && this.href === undefined && (h("span", { class: {
         [`${this.navigationButton}-chevron`]: true,
         [`${this.navigationButton}-chevron--rotate`]: this.expanded === true,
         'mg-a11y-animation': true,
-      } }, h("mg-icon", { icon: "chevron-down" })))), h("div", { class: { [`${this.name}__collapse-container`]: true, [`${this.name}__collapse-container--first-level`]: this.isInMainMenu && this.isdirection(Direction.HORIZONTAL) }, hidden: !this.expanded }, h("slot", null))));
+      } }, h("mg-icon", { icon: "chevron-down" })))));
+  }
+  /**
+   * Render
+   *
+   * @returns {HTMLElement} HTML Element
+   */
+  render() {
+    const getContainerClasses = () => ({
+      [`${this.name}__collapse-container`]: true,
+      [`${this.name}__collapse-container--first-level`]: this.isInMainMenu && this.isDirection(Direction.HORIZONTAL),
+    });
+    return (h(Host, { role: "menuitem", "aria-haspopup": this.hasChildren.toString() }, this.isDirection(Direction.HORIZONTAL) && this.hasChildren && this.href === undefined ? (h("mg-popover", { display: this.expanded, placement: "bottom-start", arrowHide: true, "onDisplay-change": this.handlePopoverDisplay }, this.renderInteractiveElement(), h("div", { class: getContainerClasses(), slot: "content" }, this.renderSlot()))) : ([
+      this.renderInteractiveElement(),
+      h("div", { class: getContainerClasses(), hidden: !this.expanded }, this.renderSlot()),
+    ])));
   }
   static get is() { return "mg-menu-item"; }
   static get encapsulation() { return "shadow"; }
@@ -222,7 +258,7 @@ export class MgMenuItem {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Define menu-item badge\nwhen defined menu-item contain an anchor instead of button"
+          "text": "Define menu-item href\nwhen defined menu-item contain an anchor instead of button"
         },
         "attribute": "href",
         "reflect": false
@@ -250,29 +286,6 @@ export class MgMenuItem {
         "reflect": true,
         "defaultValue": "Status.VISIBLE"
       },
-      "size": {
-        "type": "string",
-        "mutable": false,
-        "complexType": {
-          "original": "MenuItemSizeType",
-          "resolved": "\"large\" | \"medium\" | \"regular\"",
-          "references": {
-            "MenuItemSizeType": {
-              "location": "import",
-              "path": "./mg-menu-item.conf"
-            }
-          }
-        },
-        "required": false,
-        "optional": false,
-        "docs": {
-          "tags": [],
-          "text": "Define menu-item size. Default: \"large\"."
-        },
-        "attribute": "size",
-        "reflect": false,
-        "defaultValue": "'large'"
-      },
       "expanded": {
         "type": "boolean",
         "mutable": true,
@@ -295,23 +308,47 @@ export class MgMenuItem {
   }
   static get states() {
     return {
+      "size": {},
       "navigationButtonClassList": {},
       "direction": {},
       "isInMainMenu": {},
-      "hasChildren": {}
+      "hasChildren": {},
+      "displayNotificationBadge": {}
     };
   }
+  static get events() {
+    return [{
+        "method": "statusChange",
+        "name": "status-change",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [],
+          "text": "Emited event when status change"
+        },
+        "complexType": {
+          "original": "MgMenuItem['status']",
+          "resolved": "Status.ACTIVE | Status.DISABLED | Status.HIDDEN | Status.VISIBLE",
+          "references": {
+            "MgMenuItem": {
+              "location": "global"
+            }
+          }
+        }
+      }];
+  }
   static get elementRef() { return "element"; }
   static get watchers() {
     return [{
         "propName": "status",
         "methodName": "validateStatus"
-      }, {
-        "propName": "size",
-        "methodName": "validateSize"
       }, {
         "propName": "expanded",
         "methodName": "validateExpanded"
+      }, {
+        "propName": "size",
+        "methodName": "validateSize"
       }, {
         "propName": "hasChildren",
         "methodName": "validateHasChildren"

package/dist/collection/components/molecules/mg-details/mg-details.js

@@ -1,14 +1,6 @@
 import { h } from '@stencil/core';
 export class MgDetails {
   constructor() {
-    /**
-     * Hide summary element
-     */
-    this.hideSummary = false;
-    /**
-     * Define if details are diplayed
-     */
-    this.expanded = false;
     /**
      * Handle details toggle
      *
@@ -17,6 +9,10 @@ export class MgDetails {
     this.handleToggle = () => {
       this.expanded = this.details.open;
     };
+    this.toggleClosed = undefined;
+    this.toggleOpened = undefined;
+    this.hideSummary = false;
+    this.expanded = false;
   }
   validateTitles(newValue) {
     if (newValue === undefined || newValue.trim() === '') {

package/dist/collection/components/molecules/mg-form/mg-form.js

@@ -5,28 +5,6 @@ export class MgForm {
   constructor() {
     // Classes
     this.classAllRequired = 'mg-form--all-required';
-    /**
-     * Identifier is used for the element ID (id is a reserved prop in Stencil.js)
-     * If not set, it will be created.
-     */
-    this.identifier = createID('mg-form');
-    /**
-     * Input name
-     * If not set the value equals the identifier
-     */
-    this.name = this.identifier;
-    /**
-     * Define if form is readonly
-     */
-    this.readonly = false;
-    /**
-     * Define if form is disabled
-     */
-    this.disabled = false;
-    /**
-     * Component classes
-     */
-    this.classList = new ClassList(['mg-form']);
     /**
      * Define required message based on mg-inputs required elements
      * Also
@@ -96,6 +74,14 @@ export class MgForm {
           input.addEventListener('input-valid', this.checkValidity);
       });
     };
+    this.identifier = createID('mg-form');
+    this.name = this.identifier;
+    this.readonly = false;
+    this.disabled = false;
+    this.valid = undefined;
+    this.invalid = undefined;
+    this.classList = new ClassList(['mg-form']);
+    this.requiredMessage = undefined;
   }
   handleAttributeChange() {
     this.setMgInputs();

package/dist/collection/components/molecules/mg-illustrated-message/mg-illustrated-message.css

@@ -20,13 +20,13 @@
   max-width: 47.5rem;
 }
 .mg-illustrated-message__illustration {
-  max-height: 33.5rem;
+  max-height: 18.4rem;
 }
 .mg-illustrated-message__illustration ::slotted([slot=illustration]) {
   width: auto;
   height: auto;
   max-width: 100%;
-  max-height: 33.5rem;
+  max-height: 18.4rem;
 }
 .mg-illustrated-message__illustration.mg-illustrated-message__illustration--small {
   max-height: 6rem;

package/dist/collection/components/molecules/mg-illustrated-message/mg-illustrated-message.js

@@ -2,13 +2,7 @@ import { h } from '@stencil/core';
 import { isTagName } from '../../../utils/components.utils';
 export class MgIllustratedMessage {
   constructor() {
-    /**
-     * Define illustration size
-     */
     this.size = 'regular';
-    /**
-     * Define component orientation
-     */
     this.direction = 'vertical';
   }
   /*************
@@ -21,13 +15,14 @@ export class MgIllustratedMessage {
    */
   componentDidLoad() {
     const headingTags = ['h1', 'h2', 'h3', 'h4', 'h5', 'h6'];
-    const imageTags = ['img', 'svg'];
+    const slottedIllustrations = this.element.querySelectorAll('[slot="illustration"]');
     if (!isTagName(this.element.querySelector('[slot="title"]'), headingTags)) {
       throw new Error(`<mg-illustrated-message> Slotted title must be a heading: ${headingTags.join(', ')}`);
     }
-    else if (!isTagName(this.element.querySelector('[slot="illustration"]'), imageTags)) {
-      throw new Error(`<mg-illustrated-message> Slotted illustration must be an image: ${imageTags.join(', ')}`);
+    else if (slottedIllustrations.length !== 1) {
+      throw new Error('<mg-illustrated-message> Slotted illustration must be present and unique.');
     }
+    slottedIllustrations[0].setAttribute('aria-hidden', 'true');
   }
   /**
    * Render

package/dist/collection/components/molecules/mg-message/mg-message.css

@@ -1,47 +1,47 @@
+:host {
+  --mg-card-padding: 0;
+  --mg-card-border-radius: var(--mg-message-border-radius);
+  --mg-card-border: none;
+  --mg-card-overflow: hidden;
+}
+
 .mg-message {
   display: inline-block;
-  position: relative;
-  box-sizing: border-box;
   min-height: var(--default-size);
-  overflow: hidden;
-  background-color: white;
-  border-radius: var(--mg-message-border-radius);
-  box-shadow: var(--box-shadow);
 }
-.mg-message::before {
-  content: "";
+.mg-message__bar {
   position: absolute;
   top: 0;
   left: 0;
   width: 0.3rem;
   height: 100%;
 }
-.mg-message.mg-message--info::before {
+.mg-message.mg-message--info .mg-message__bar {
   background-color: hsl(var(--color-info));
 }
 .mg-message.mg-message--info .mg-message__icon {
   color: hsl(var(--color-info));
 }
-.mg-message.mg-message--warning::before {
+.mg-message.mg-message--warning .mg-message__bar {
   background-color: hsl(var(--color-warning));
 }
 .mg-message.mg-message--warning .mg-message__icon {
   color: hsl(var(--color-warning));
 }
-.mg-message.mg-message--success::before {
+.mg-message.mg-message--success .mg-message__bar {
   background-color: hsl(var(--color-success));
 }
 .mg-message.mg-message--success .mg-message__icon {
   color: hsl(var(--color-success));
 }
-.mg-message.mg-message--danger::before {
+.mg-message.mg-message--danger .mg-message__bar {
   background-color: hsl(var(--color-danger));
 }
 .mg-message.mg-message--danger .mg-message__icon {
   color: hsl(var(--color-danger));
 }
 .mg-message.mg-message--close-button {
-  padding-right: 3.4rem;
+  --mg-card-padding: 0 3.4rem 0 0;
 }
 .mg-message.mg-message--hide {
   display: none;
@@ -50,14 +50,12 @@
   margin: 0;
   padding: 0;
 }
-
 .mg-message__icon {
   position: absolute;
   top: calc((var(--default-size) - var(--mg-icon-regular-size)) / 2);
   left: 1.3rem;
   line-height: 1;
 }
-
 .mg-message__content {
   display: flex;
   flex-wrap: wrap;
@@ -65,28 +63,31 @@
   align-content: stretch;
   padding: 0 1rem 0 3.8rem;
 }
-
 .mg-message__content-slot {
   flex-grow: 1;
   margin: 0.84rem 0;
 }
-
 .mg-message__content-separator {
   display: inline-block;
   width: 4.5rem;
   height: 0;
 }
-
 .mg-message__content-actions-slot {
   padding: 1rem 0;
   text-align: right;
 }
-
 .mg-message__close-button {
   position: absolute;
   top: 0;
   right: 0;
 }
+.mg-message ::slotted(*) {
+  --mg-card-border: var(--mg-card-border-default);
+  --mg-card-padding: var(--mg-card-padding-default);
+  --mg-card-border-radius: var(--mg-card-border-radius-default);
+  --mg-card-background: var(--mg-card-background-default);
+  --mg-card-box-shadow: var(--mg-card-box-shadow-default);
+}
 
 .mg-message,
 mg-message {