@mgdis/mg-components 6.21.0 → 6.22.0

package/dist/types/components.d.ts

@@ -8,6 +8,7 @@ import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
 import { MgActionMoreButtonType, MgActionMoreDividerType, MgActionMoreIconType, MgActionMoreItemType } from "./components/molecules/mg-action-more/mg-action-more.conf";
 import { VariantStyleType, VariantType } from "./components/molecules/mg-alert/mg-alert.conf";
 import { BadgeVariantType } from "./components/atoms/mg-badge/mg-badge.conf";
+import { BreadcrumbItemType } from "./components/molecules/mg-breadcrumb/mg-breadcrumb.conf";
 import { ButtonType, SizeType, VariantType as VariantType1 } from "./components/atoms/mg-button/mg-button.conf";
 import { RadiusSizeType } from "./components/atoms/mg-card/mg-card.conf";
 import { labelHeading, TooltipPosition, Width } from "./components/molecules/inputs/mg-input/mg-input.conf";
@@ -19,12 +20,13 @@ import { Direction, Option, Option as ToggleOption } from "./types";
 import { RequestMappingType, ResponseMappingType } from "./components/molecules/inputs/mg-input-combobox/mg-input-combobox.conf";
 import { Format, NumericType } from "./components/molecules/inputs/mg-input-numeric/mg-input-numeric.conf";
 import { RadioOption } from "./components/molecules/inputs/mg-input-radio/mg-input-radio.conf";
-import { EditorOptionsType } from "./components/molecules/inputs/mg-input-rich-text-editor/editor";
+import { ButtonsOption } from "./components/molecules/inputs/mg-input-rich-text-editor/editor/editor.conf";
+import { SanitizerOptions } from "@mgdis/sanitize-html";
 import { SelectOption } from "./components/molecules/inputs/mg-input-select/mg-input-select.conf";
 import { OptionType, TextType } from "./components/molecules/inputs/mg-input-text/mg-input-text.conf";
 import { IconType as IconType1 } from "./components";
-import { IconType as IconType2, SizeType as SizeType1, SlotLabelType } from "./components/molecules/internals/mg-item-more/mg-item-more.conf";
-import { ItemMoreType, MenuSizeType } from "./components/molecules/menus/mg-menu/mg-menu.conf";
+import { IconType as IconType2, SlotLabelType } from "./components/molecules/internals/mg-item-more/mg-item-more.conf";
+import { ItemMoreType } from "./components/molecules/menus/mg-menu/mg-menu.conf";
 import { MgMenuStatusType, TargetType } from "./components/molecules/menus/mg-menu-item/mg-menu-item.conf";
 import { VariantStyleType as VariantStyleType1, VariantType as VariantType2 } from "./components/molecules/mg-message/mg-message.conf";
 import { DialogRoleType } from "./components/molecules/mg-modal/mg-modal.conf";
@@ -34,11 +36,12 @@ import { Placement } from "@popperjs/core";
 import { AriaRoleType as AriaRoleType1 } from "./components/molecules/mg-progress/mg-progress.conf";
 import { SkipLink } from "./components/molecules/mg-skip-links/mg-skip-links.conf";
 import { ColumnsType, TableSizeType } from "./components/molecules/mg-table/mg-table.conf";
-import { SizeType as SizeType2, TabItem } from "./components/molecules/mg-tabs/mg-tabs.conf";
+import { TabItem } from "./components/molecules/mg-tabs/mg-tabs.conf";
 import { TagVariantType } from "./components/atoms/mg-tag/mg-tag.conf";
 export { MgActionMoreButtonType, MgActionMoreDividerType, MgActionMoreIconType, MgActionMoreItemType } from "./components/molecules/mg-action-more/mg-action-more.conf";
 export { VariantStyleType, VariantType } from "./components/molecules/mg-alert/mg-alert.conf";
 export { BadgeVariantType } from "./components/atoms/mg-badge/mg-badge.conf";
+export { BreadcrumbItemType } from "./components/molecules/mg-breadcrumb/mg-breadcrumb.conf";
 export { ButtonType, SizeType, VariantType as VariantType1 } from "./components/atoms/mg-button/mg-button.conf";
 export { RadiusSizeType } from "./components/atoms/mg-card/mg-card.conf";
 export { labelHeading, TooltipPosition, Width } from "./components/molecules/inputs/mg-input/mg-input.conf";
@@ -50,12 +53,13 @@ export { Direction, Option, Option as ToggleOption } from "./types";
 export { RequestMappingType, ResponseMappingType } from "./components/molecules/inputs/mg-input-combobox/mg-input-combobox.conf";
 export { Format, NumericType } from "./components/molecules/inputs/mg-input-numeric/mg-input-numeric.conf";
 export { RadioOption } from "./components/molecules/inputs/mg-input-radio/mg-input-radio.conf";
-export { EditorOptionsType } from "./components/molecules/inputs/mg-input-rich-text-editor/editor";
+export { ButtonsOption } from "./components/molecules/inputs/mg-input-rich-text-editor/editor/editor.conf";
+export { SanitizerOptions } from "@mgdis/sanitize-html";
 export { SelectOption } from "./components/molecules/inputs/mg-input-select/mg-input-select.conf";
 export { OptionType, TextType } from "./components/molecules/inputs/mg-input-text/mg-input-text.conf";
 export { IconType as IconType1 } from "./components";
-export { IconType as IconType2, SizeType as SizeType1, SlotLabelType } from "./components/molecules/internals/mg-item-more/mg-item-more.conf";
-export { ItemMoreType, MenuSizeType } from "./components/molecules/menus/mg-menu/mg-menu.conf";
+export { IconType as IconType2, SlotLabelType } from "./components/molecules/internals/mg-item-more/mg-item-more.conf";
+export { ItemMoreType } from "./components/molecules/menus/mg-menu/mg-menu.conf";
 export { MgMenuStatusType, TargetType } from "./components/molecules/menus/mg-menu-item/mg-menu-item.conf";
 export { VariantStyleType as VariantStyleType1, VariantType as VariantType2 } from "./components/molecules/mg-message/mg-message.conf";
 export { DialogRoleType } from "./components/molecules/mg-modal/mg-modal.conf";
@@ -65,7 +69,7 @@ export { Placement } from "@popperjs/core";
 export { AriaRoleType as AriaRoleType1 } from "./components/molecules/mg-progress/mg-progress.conf";
 export { SkipLink } from "./components/molecules/mg-skip-links/mg-skip-links.conf";
 export { ColumnsType, TableSizeType } from "./components/molecules/mg-table/mg-table.conf";
-export { SizeType as SizeType2, TabItem } from "./components/molecules/mg-tabs/mg-tabs.conf";
+export { TabItem } from "./components/molecules/mg-tabs/mg-tabs.conf";
 export { TagVariantType } from "./components/atoms/mg-tag/mg-tag.conf";
 export namespace Components {
     interface MgActionMore {
@@ -124,6 +128,12 @@ export namespace Components {
          */
         "variant"?: BadgeVariantType;
     }
+    interface MgBreadcrumb {
+        /**
+          * Breadcrumb items (hierarchical order: root → current page).
+         */
+        "items": BreadcrumbItemType[];
+    }
     interface MgButton {
         /**
           * Option to set input disable on click, in order to prevent multi-click. Parent component have to remove the attribute 'disabled' when the process ends.
@@ -1212,8 +1222,8 @@ export namespace Components {
          */
         "displayError": () => Promise<void>;
         /**
-          * Get editor content in HTML format
-          * @returns HTML content of the editor
+          * Get editor content as HTML
+          * @returns HTML content of the editor (sanitized)
          */
         "getEditorHTML": () => Promise<string>;
         /**
@@ -1248,9 +1258,14 @@ export namespace Components {
          */
         "labelOnTop": boolean;
         /**
-          * Editor modules configuration
+          * Editor modules configuration. Must be passed as an array (e.g. modules=['bold', 'italic', '|', 'ul', 'ol']). Use `|` for a separator/divider in the toolbar. Available modules: - **Text formatting**: `bold`, `italic`, `underline`, `strikethrough`, `eraser` - **Lists**: `ul` (unordered list), `ol` (ordered list) - **Text positioning**: `superscript`, `subscript` - **Colors**: `brush` (text color/background) - **Media**: `link`, `image`, `file` - **Tables**: `table` - **History**: `undo`, `redo` - **Other**: `print`, `source` (HTML source editor)
+         */
+        "modules"?: ButtonsOption;
+        /**
+          * Input name If not set the value equals the identifier
+          * @default this.identifier
          */
-        "modules"?: EditorOptionsType['modules'];
+        "name": string;
         /**
           * Define input pattern to validate Please refer to the Pattern section in the input documentation for detailed information on using regular expressions in components.
          */
@@ -1278,10 +1293,14 @@ export namespace Components {
          */
         "reset": () => Promise<void>;
         /**
-          * Define the number of visible text lines for the control
+          * Define the number of visible text lines for the editor. Impacts the editor height. Content can grow beyond this minimum.
           * @default 5
          */
         "rows": number;
+        /**
+          * Sanitizer configuration in native format. Use disallowTags (array of tag names) and/or disallowAttributes (object mapping tag names to string arrays). Use "*" as tag key to disallow attributes on all tags.
+         */
+        "sanitizerOptions"?: SanitizerOptions;
         /**
           * Set an error and display a custom error message. This method can be used to set the component's error state from its context by passing a boolean value to the `valid` parameter. It must be paired with an error message to display for the given context. When used to set validity to `false`, you should use this method again to reset the validity to `true`.
           * @param valid - value indicating the validity
@@ -1768,10 +1787,6 @@ export namespace Components {
           * @default { icon: 'ellipsis-vertical' }
          */
         "icon"?: IconType2;
-        /**
-          * Define component child menu size.
-         */
-        "size"?: SizeType1;
         /**
           * Define slot label element
           * @default { display: false }
@@ -1796,7 +1811,7 @@ export namespace Components {
          */
         "direction": Direction;
         /**
-          * Customize "mg-item-more" element Used with direction: 'vertical' to manage overflow
+          * Customize "mg-item-more" element Used with direction: 'horizontal' to manage overflow
          */
         "itemmore"?: ItemMoreType;
         /**
@@ -1804,10 +1819,10 @@ export namespace Components {
          */
         "label": string;
         /**
-          * Define mg-menu size
-          * @default 'medium'
+          * Size of the menu items
+          * @deprecated this prop is deprecated and will be removed in future releases
          */
-        "size": MenuSizeType;
+        "size": never;
     }
     interface MgMenuItem {
         /**
@@ -1824,6 +1839,11 @@ export namespace Components {
           * @default createID('mg-menu-item')
          */
         "identifier": string;
+        /**
+          * Define menu-item isIcon style.
+          * @default false
+         */
+        "isIcon"?: boolean;
         /**
           * Define menu-item status.
           * @default 'visible'
@@ -2028,6 +2048,11 @@ export namespace Components {
         "links": SkipLink[];
     }
     interface MgTable {
+        /**
+          * Define if table has no outer border
+          * @default false
+         */
+        "borderHide": boolean;
         /**
           * Define column properties
          */
@@ -2062,10 +2087,10 @@ export namespace Components {
          */
         "label": string;
         /**
-          * Define tabs size
-          * @default 'medium'
+          * Size of the tabs items.
+          * @deprecated this prop is deprecated and will be removed in future releases. Please use CSS custom properties to set the size of tabs items.
          */
-        "size": SizeType2;
+        "size": never;
     }
     interface MgTag {
         /**
@@ -2245,6 +2270,12 @@ declare global {
         prototype: HTMLMgBadgeElement;
         new (): HTMLMgBadgeElement;
     };
+    interface HTMLMgBreadcrumbElement extends Components.MgBreadcrumb, HTMLStencilElement {
+    }
+    var HTMLMgBreadcrumbElement: {
+        prototype: HTMLMgBreadcrumbElement;
+        new (): HTMLMgBreadcrumbElement;
+    };
     interface HTMLMgButtonElementEventMap {
         "disabled-change": HTMLMgButtonElement['disabled'];
     }
@@ -2773,6 +2804,7 @@ declare global {
         "mg-action-more": HTMLMgActionMoreElement;
         "mg-alert": HTMLMgAlertElement;
         "mg-badge": HTMLMgBadgeElement;
+        "mg-breadcrumb": HTMLMgBreadcrumbElement;
         "mg-button": HTMLMgButtonElement;
         "mg-card": HTMLMgCardElement;
         "mg-character-left": HTMLMgCharacterLeftElement;
@@ -2885,6 +2917,12 @@ declare namespace LocalJSX {
          */
         "variant"?: BadgeVariantType;
     }
+    interface MgBreadcrumb {
+        /**
+          * Breadcrumb items (hierarchical order: root → current page).
+         */
+        "items": BreadcrumbItemType[];
+    }
     interface MgButton {
         /**
           * Option to set input disable on click, in order to prevent multi-click. Parent component have to remove the attribute 'disabled' when the process ends.
@@ -3929,9 +3967,14 @@ declare namespace LocalJSX {
          */
         "labelOnTop"?: boolean;
         /**
-          * Editor modules configuration
+          * Editor modules configuration. Must be passed as an array (e.g. modules=['bold', 'italic', '|', 'ul', 'ol']). Use `|` for a separator/divider in the toolbar. Available modules: - **Text formatting**: `bold`, `italic`, `underline`, `strikethrough`, `eraser` - **Lists**: `ul` (unordered list), `ol` (ordered list) - **Text positioning**: `superscript`, `subscript` - **Colors**: `brush` (text color/background) - **Media**: `link`, `image`, `file` - **Tables**: `table` - **History**: `undo`, `redo` - **Other**: `print`, `source` (HTML source editor)
+         */
+        "modules"?: ButtonsOption;
+        /**
+          * Input name If not set the value equals the identifier
+          * @default this.identifier
          */
-        "modules"?: EditorOptionsType['modules'];
+        "name"?: string;
         /**
           * Emited event when checking validity
          */
@@ -3963,10 +4006,14 @@ declare namespace LocalJSX {
          */
         "required"?: boolean;
         /**
-          * Define the number of visible text lines for the control
+          * Define the number of visible text lines for the editor. Impacts the editor height. Content can grow beyond this minimum.
           * @default 5
          */
         "rows"?: number;
+        /**
+          * Sanitizer configuration in native format. Use disallowTags (array of tag names) and/or disallowAttributes (object mapping tag names to string arrays). Use "*" as tag key to disallow attributes on all tags.
+         */
+        "sanitizerOptions"?: SanitizerOptions;
         /**
           * Add a tooltip message next to the input
          */
@@ -4403,10 +4450,6 @@ declare namespace LocalJSX {
           * @default { icon: 'ellipsis-vertical' }
          */
         "icon"?: IconType2;
-        /**
-          * Define component child menu size.
-         */
-        "size"?: SizeType1;
         /**
           * Define slot label element
           * @default { display: false }
@@ -4431,7 +4474,7 @@ declare namespace LocalJSX {
          */
         "direction"?: Direction;
         /**
-          * Customize "mg-item-more" element Used with direction: 'vertical' to manage overflow
+          * Customize "mg-item-more" element Used with direction: 'horizontal' to manage overflow
          */
         "itemmore"?: ItemMoreType;
         /**
@@ -4439,10 +4482,10 @@ declare namespace LocalJSX {
          */
         "label": string;
         /**
-          * Define mg-menu size
-          * @default 'medium'
+          * Size of the menu items
+          * @deprecated this prop is deprecated and will be removed in future releases
          */
-        "size"?: MenuSizeType;
+        "size"?: never;
     }
     interface MgMenuItem {
         /**
@@ -4459,6 +4502,11 @@ declare namespace LocalJSX {
           * @default createID('mg-menu-item')
          */
         "identifier"?: string;
+        /**
+          * Define menu-item isIcon style.
+          * @default false
+         */
+        "isIcon"?: boolean;
         /**
           * Emited event when item is loaded
          */
@@ -4711,6 +4759,11 @@ declare namespace LocalJSX {
         "onGo-to-anchor"?: (event: MgSkipLinksCustomEvent<string>) => void;
     }
     interface MgTable {
+        /**
+          * Define if table has no outer border
+          * @default false
+         */
+        "borderHide"?: boolean;
         /**
           * Define column properties
          */
@@ -4749,10 +4802,10 @@ declare namespace LocalJSX {
          */
         "onActive-tab-change"?: (event: MgTabsCustomEvent<HTMLMgTabsElement['activeTab']>) => void;
         /**
-          * Define tabs size
-          * @default 'medium'
+          * Size of the tabs items.
+          * @deprecated this prop is deprecated and will be removed in future releases. Please use CSS custom properties to set the size of tabs items.
          */
-        "size"?: SizeType2;
+        "size"?: never;
     }
     interface MgTag {
         /**
@@ -4807,6 +4860,7 @@ declare namespace LocalJSX {
         "mg-action-more": MgActionMore;
         "mg-alert": MgAlert;
         "mg-badge": MgBadge;
+        "mg-breadcrumb": MgBreadcrumb;
         "mg-button": MgButton;
         "mg-card": MgCard;
         "mg-character-left": MgCharacterLeft;
@@ -4857,6 +4911,7 @@ declare module "@stencil/core" {
             "mg-action-more": LocalJSX.MgActionMore & JSXBase.HTMLAttributes<HTMLMgActionMoreElement>;
             "mg-alert": LocalJSX.MgAlert & JSXBase.HTMLAttributes<HTMLMgAlertElement>;
             "mg-badge": LocalJSX.MgBadge & JSXBase.HTMLAttributes<HTMLMgBadgeElement>;
+            "mg-breadcrumb": LocalJSX.MgBreadcrumb & JSXBase.HTMLAttributes<HTMLMgBreadcrumbElement>;
             "mg-button": LocalJSX.MgButton & JSXBase.HTMLAttributes<HTMLMgButtonElement>;
             "mg-card": LocalJSX.MgCard & JSXBase.HTMLAttributes<HTMLMgCardElement>;
             "mg-character-left": LocalJSX.MgCharacterLeft & JSXBase.HTMLAttributes<HTMLMgCharacterLeftElement>;