@syncfusion/ej2-ribbon 24.2.3 → 25.1.35

package/dist/global/index.d.ts

@@ -1,6 +1,6 @@
 /*!
 *  filename: index.d.ts
-*  version : 24.2.3
+*  version : 25.1.35
 *  Copyright Syncfusion Inc. 2001 - 2023. All rights reserved.
 *  Use of this code is subject to the terms of our license.
 *  A copy of the current license can be obtained at any time by e-mailing

package/package.json

@@ -1,8 +1,8 @@
 {
   "_from": "@syncfusion/ej2-ribbon@*",
-  "_id": "@syncfusion/ej2-ribbon@24.1.44",
+  "_id": "@syncfusion/ej2-ribbon@21.29.0",
   "_inBundle": false,
-  "_integrity": "sha512-ATh/cX903EDYFrNVGVp8WJf5Bb+cgft1xqTXF6tsKxUuEKCfm+5EAjXQWWu5qB/gJsX4rOu/zImTbZMgabhETA==",
+  "_integrity": "sha512-VYJvBTL4kiCK3QCcu6kdGp8ymjBNjEk1AaJVIZbqJdyp4r3sJCBqy6SAymQ9pM6woSvFMplL37Bj/IyIGe/yRw==",
   "_location": "/@syncfusion/ej2-ribbon",
   "_phantomChildren": {},
   "_requested": {
@@ -23,10 +23,10 @@
     "/@syncfusion/ej2-react-ribbon",
     "/@syncfusion/ej2-vue-ribbon"
   ],
-  "_resolved": "https://nexus.syncfusion.com/repository/ej2-hotfix-new/@syncfusion/ej2-ribbon/-/ej2-ribbon-24.1.44.tgz",
-  "_shasum": "b14c7fceb54d1d85cb6e5b0a96a65596a2058705",
+  "_resolved": "https://nexus.syncfusioninternal.com/repository/ej2-release/@syncfusion/ej2-ribbon/-/ej2-ribbon-21.29.0.tgz",
+  "_shasum": "62a1aec44f748a1b923e70e0b5a1bbf54e230458",
   "_spec": "@syncfusion/ej2-ribbon@*",
-  "_where": "/jenkins/workspace/elease-automation_release_24.1.1/packages/included",
+  "_where": "/jenkins/workspace/elease-automation_release_25.1.1/packages/included",
   "author": {
     "name": "Syncfusion Inc."
   },
@@ -35,13 +35,13 @@
   },
   "bundleDependencies": false,
   "dependencies": {
-    "@syncfusion/ej2-base": "~24.2.3",
-    "@syncfusion/ej2-buttons": "~24.2.3",
-    "@syncfusion/ej2-dropdowns": "~24.2.3",
-    "@syncfusion/ej2-lists": "~24.2.3",
-    "@syncfusion/ej2-navigations": "~24.2.3",
-    "@syncfusion/ej2-popups": "~24.2.3",
-    "@syncfusion/ej2-splitbuttons": "~24.2.3"
+    "@syncfusion/ej2-base": "~25.1.35",
+    "@syncfusion/ej2-buttons": "~25.1.35",
+    "@syncfusion/ej2-dropdowns": "~25.1.35",
+    "@syncfusion/ej2-lists": "~25.1.35",
+    "@syncfusion/ej2-navigations": "~25.1.35",
+    "@syncfusion/ej2-popups": "~25.1.35",
+    "@syncfusion/ej2-splitbuttons": "~25.1.35"
   },
   "deprecated": false,
   "description": "Essential JS 2 Component",
@@ -62,6 +62,6 @@
     "url": "git+https://github.com/syncfusion/ej2-ribbon-component.git"
   },
   "typings": "index.d.ts",
-  "version": "24.2.3",
+  "version": "25.1.35",
   "sideEffects": false
 }

package/src/global.js

@@ -1,3 +1,3 @@
 import * as index from './index';
-index.Ribbon.Inject(index.RibbonButton, index.RibbonDropDown, index.RibbonSplitButton, index.RibbonCheckBox, index.RibbonColorPicker, index.RibbonComboBox, index.RibbonGroupButton, index.RibbonFileMenu, index.RibbonBackstage);
+index.Ribbon.Inject(index.RibbonButton, index.RibbonDropDown, index.RibbonSplitButton, index.RibbonCheckBox, index.RibbonColorPicker, index.RibbonComboBox, index.RibbonGroupButton, index.RibbonFileMenu, index.RibbonBackstage, index.RibbonKeyTip, index.RibbonContextualTab, index.RibbonGallery);
 export * from './index';

package/src/ribbon/base/constant.d.ts

@@ -24,6 +24,8 @@ export declare const RIBBON_POPUP_CONTROL: string;
 /** @hidden */
 export declare const RIBBON_POPUP_OPEN: string;
 /** @hidden */
+export declare const RIBBON_KEYTIP: string;
+/** @hidden */
 export declare const SPACE: string;
 /** @hidden */
 export declare const HORIZONTAL_SCROLLBAR: string;
@@ -32,6 +34,8 @@ export declare const HIDE_CSS: string;
 /** @hidden */
 export declare const RIBBON_TAB: string;
 /** @hidden */
+export declare const RIBBON_CONTEXTUAL_TAB: string;
+/** @hidden */
 export declare const RIBBON_TAB_ACTIVE: string;
 /** @hidden */
 export declare const RIBBON_TAB_ITEM: string;
@@ -64,6 +68,8 @@ export declare const RIBBON_GROUP_BUTTON: string;
 /** @hidden */
 export declare const RIBBON_GROUP_BUTTON_OVERFLOW_POPUP: string;
 /** @hidden */
+export declare const RIBBON_GROUP_BUTTON_CONTENT: string;
+/** @hidden */
 export declare const RIBBON_GROUP_CONTAINER: string;
 /** @hidden */
 export declare const RIBBON_OF_TAB_CONTAINER: string;
@@ -188,6 +194,8 @@ export declare const RIBBON_HELP_PANE_TEMPLATE_ID: string;
 /** @hidden */
 export declare const RIBBON_GROUP_BUTTON_ID: string;
 /** @hidden */
+export declare const RIBBON_KEYTIP_ID: string;
+/** @hidden */
 export declare const RIBBON_FILE_MENU_WIDTH: string;
 /** @hidden */
 export declare const RIBBON_HELP_PANE_TEMPLATE_WIDTH: string;

package/src/ribbon/base/constant.js

@@ -24,6 +24,8 @@ export var RIBBON_POPUP_CONTROL = 'e-ribbon-popup-control';
 /** @hidden */
 export var RIBBON_POPUP_OPEN = 'e-ribbon-open';
 /** @hidden */
+export var RIBBON_KEYTIP = 'e-ribbon-keytip';
+/** @hidden */
 export var SPACE = ' ';
 /** @hidden */
 export var HORIZONTAL_SCROLLBAR = 'e-hscroll-bar';
@@ -32,6 +34,8 @@ export var HIDE_CSS = 'e-ribbon-hide';
 /** @hidden */
 export var RIBBON_TAB = 'e-ribbon-tab';
 /** @hidden */
+export var RIBBON_CONTEXTUAL_TAB = 'e-ribbon-contextual-tab';
+/** @hidden */
 export var RIBBON_TAB_ACTIVE = 'e-ribbon-active';
 /** @hidden */
 export var RIBBON_TAB_ITEM = 'e-ribbon-tab-item';
@@ -64,6 +68,8 @@ export var RIBBON_GROUP_BUTTON = 'e-ribbon-group-button';
 /** @hidden */
 export var RIBBON_GROUP_BUTTON_OVERFLOW_POPUP = 'e-ribbon-group-button-overflow-popup';
 /** @hidden */
+export var RIBBON_GROUP_BUTTON_CONTENT = 'e-ribbon-group-button-content';
+/** @hidden */
 export var RIBBON_GROUP_CONTAINER = 'e-ribbon-group-container';
 /** @hidden */
 export var RIBBON_OF_TAB_CONTAINER = 'e-ribbon-of-tab';
@@ -188,6 +194,8 @@ export var RIBBON_HELP_PANE_TEMPLATE_ID = '_helppanetemplate';
 /** @hidden */
 export var RIBBON_GROUP_BUTTON_ID = '_grpbtn';
 /** @hidden */
+export var RIBBON_KEYTIP_ID = '_keytip';
+/** @hidden */
 export var RIBBON_FILE_MENU_WIDTH = '--fileMenuWidth';
 /** @hidden */
 export var RIBBON_HELP_PANE_TEMPLATE_WIDTH = '--helpTemplateWidth';

package/src/ribbon/base/interface.d.ts

@@ -1,5 +1,5 @@
 import { BaseEventArgs } from '@syncfusion/ej2-base';
-import { RibbonCollectionModel, RibbonGroupButtonItemModel, RibbonGroupModel, RibbonItemModel, RibbonTooltipModel } from '../models';
+import { RibbonCollectionModel, RibbonGalleryItemModel, RibbonGroupButtonItemModel, RibbonGroupModel, RibbonItemModel, RibbonTooltipModel } from '../models';
 /**
  * Defines the layout types of ribbon.
  */
@@ -100,6 +100,10 @@ export declare enum RibbonItemType {
      * Renders the group button content as ribbon item.
      */
     GroupButton = "GroupButton",
+    /**
+     * Renders the gallery as ribbon item.
+     */
+    Gallery = "Gallery",
     /**
      * Renders the template content as ribbon item.
      */
@@ -138,6 +142,10 @@ export interface TabSelectingEventArgs extends BaseEventArgs {
      * Defines the index of the selected tab.
      */
     selectedIndex: number;
+    /**
+     * Defines whether the tab is a contextual tab.
+     */
+    isContextual: boolean;
 }
 /**
  * Event triggers after selecting the tab item.
@@ -151,6 +159,10 @@ export interface TabSelectedEventArgs extends BaseEventArgs {
      *  Defines the index of the selected tab.
      */
     selectedIndex: number;
+    /**
+     * Defines whether the tab is a contextual tab.
+     */
+    isContextual: boolean;
 }
 /**
  * Event triggers before expanding and before collapsing the ribbon.
@@ -217,6 +229,107 @@ export interface OverflowPopupEventArgs extends BaseEventArgs {
      */
     cancel?: boolean;
 }
+/**
+ * Event triggers when the gallery popup open / close.
+ */
+export interface GalleryPopupEventArgs extends BaseEventArgs {
+    /**
+     *  Defines whether to cancel the gallery popup open or close.
+     */
+    cancel: boolean;
+    /**
+     *  Provides the original event.
+     */
+    event: Event;
+    /**
+     *  Specifies name of the event.
+     */
+    name: string;
+}
+/**
+ * Event triggers when a user hovers over a gallery item.
+ */
+export interface GalleryHoverEventArgs extends BaseEventArgs {
+    /**
+     *  Provides the original event.
+     */
+    event: Event;
+    /**
+     *  Specifies name of the event.
+     */
+    name: string;
+    /**
+     *  Provides gallery item.
+     */
+    item: RibbonGalleryItemModel;
+}
+/**
+ * Event triggers before rendering each gallery item.
+ */
+export interface GalleryItemEventArgs extends BaseEventArgs {
+    /**
+     *  Specifies name of the event.
+     */
+    name: string;
+    /**
+     *  Provides gallery item.
+     */
+    item: RibbonGalleryItemModel;
+}
+/**
+ * Event triggers before selecting gallery item.
+ */
+export interface GalleryBeforeSelectEventArgs extends BaseEventArgs {
+    /**
+     *  Provides the previous selected gallery item.
+     */
+    previousItem: RibbonGalleryItemModel;
+    /**
+     *  Provides the current selecting gallery item.
+     */
+    currentItem: RibbonGalleryItemModel;
+    /**
+     *  Defines whether to cancel the selecting event or not.
+     */
+    cancel: boolean;
+    /**
+     *  Specifies name of the event.
+     */
+    name: string;
+    /**
+     *  Provides whether the change is triggered by user interaction.
+     */
+    isInteracted: boolean;
+    /**
+     *  Provides the original event.
+     */
+    event: Event;
+}
+/**
+ * Event triggers after selected gallery item.
+ */
+export interface GallerySelectEventArgs extends BaseEventArgs {
+    /**
+     *  Provides the previous selected gallery item.
+     */
+    previousItem: RibbonGalleryItemModel;
+    /**
+     *  Provides the current selected gallery item.
+     */
+    currentItem: RibbonGalleryItemModel;
+    /**
+     *  Specifies name of the event.
+     */
+    name: string;
+    /**
+     *  Provides whether the change is triggered by user interaction.
+     */
+    isInteracted: boolean;
+    /**
+     *  Provides the original event.
+     */
+    event: Event;
+}
 /** @hidden */
 export interface itemProps {
     item?: RibbonItemModel;

package/src/ribbon/base/interface.js

@@ -103,6 +103,10 @@ export var RibbonItemType;
      * Renders the group button content as ribbon item.
      */
     RibbonItemType["GroupButton"] = "GroupButton";
+    /**
+     * Renders the gallery as ribbon item.
+     */
+    RibbonItemType["Gallery"] = "Gallery";
     /**
      * Renders the template content as ribbon item.
      */

package/src/ribbon/base/ribbon-model.d.ts

@@ -1,4 +1,4 @@
-import { addClass, append, Event, Collection, Complex, Component, EmitType, EventHandler, formatUnit, getInstance, getComponent, getUniqueID, closest, KeyboardEventArgs, KeyboardEvents } from '@syncfusion/ej2-base';import { INotifyPropertyChanged, isNullOrUndefined, isUndefined, ModuleDeclaration, NotifyPropertyChanges, Property, remove, removeClass } from '@syncfusion/ej2-base';import { Tab, TabAnimationSettings, TabAnimationSettingsModel, TabItemModel, SelectEventArgs, SelectingEventArgs, HScroll, Toolbar } from '@syncfusion/ej2-navigations';import { RibbonTab, RibbonTabModel, RibbonGroupModel, RibbonCollectionModel, RibbonItemModel, FileMenuSettings, FileMenuSettingsModel, BackStageMenu, BackStageMenuModel, RibbonItem, RibbonCollection, RibbonGroup } from '../models/index';import { commonProperties, DisplayMode, ExpandCollapseEventArgs, itemProps, LauncherClickEventArgs, OverflowPopupEventArgs, ribbonItemPropsList, RibbonLayout, ribbonTooltipData, TabSelectedEventArgs, TabSelectingEventArgs } from './interface';import { ItemOrientation, RibbonItemSize, RibbonItemType } from './interface';import { RibbonButton, RibbonComboBox, RibbonCheckBox, RibbonDropDown, RibbonColorPicker, RibbonSplitButton, RibbonGroupButton } from '../items/index';import { destroyControl, getCollection, getGroup, getIndex, getItem, getItemElement, updateCommonProperty, updateControlDisabled, isTooltipPresent, getTemplateFunction, createTooltip, destroyTooltip, updateTooltipProp } from './utils';import * as constants from './constant';import { RibbonFileMenu, RibbonBackstage } from '../modules/index';import { RibbonTooltipModel } from '../models/ribbon-tooltip-model';import { Popup } from '@syncfusion/ej2-popups';import { BeforeOpenCloseMenuEventArgs, DropDownButton, SplitButton } from '@syncfusion/ej2-splitbuttons';import { CheckBox } from '@syncfusion/ej2-buttons';
+import { addClass, append, Event, Collection, Complex, Component, EmitType, EventHandler, formatUnit, getInstance, getComponent, getUniqueID, closest, KeyboardEventArgs, KeyboardEvents } from '@syncfusion/ej2-base';import { INotifyPropertyChanged, isNullOrUndefined, isUndefined, ModuleDeclaration, NotifyPropertyChanges, Property, remove, removeClass, MouseEventArgs } from '@syncfusion/ej2-base';import { Tab, TabAnimationSettings, TabAnimationSettingsModel, TabItemModel, SelectEventArgs, SelectingEventArgs, HScroll, Toolbar } from '@syncfusion/ej2-navigations';import { RibbonTab, RibbonTabModel, RibbonGroupModel, RibbonCollectionModel, RibbonItemModel, FileMenuSettings, FileMenuSettingsModel, BackStageMenu, BackStageMenuModel, RibbonItem, RibbonCollection, RibbonGroup, RibbonContextualTabSettingsModel, RibbonContextualTabSettings, RibbonGallerySettingsModel, RibbonGallerySettings } from '../models/index';import { commonProperties, DisplayMode, ExpandCollapseEventArgs, itemProps, LauncherClickEventArgs, OverflowPopupEventArgs, ribbonItemPropsList, RibbonLayout, ribbonTooltipData, TabSelectedEventArgs, TabSelectingEventArgs } from './interface';import { ItemOrientation, RibbonItemSize, RibbonItemType } from './interface';import { RibbonButton, RibbonComboBox, RibbonCheckBox, RibbonDropDown, RibbonColorPicker, RibbonSplitButton, RibbonGroupButton } from '../items/index';import { destroyControl, getCollection, getGroup, getIndex, getItem, getItemElement, updateCommonProperty, updateControlDisabled, isTooltipPresent, getTemplateFunction, createTooltip, destroyTooltip, updateTooltipProp } from './utils';import * as constants from './constant';import { RibbonFileMenu, RibbonBackstage, RibbonKeyTip } from '../modules/index';import { RibbonTooltipModel } from '../models/ribbon-tooltip-model';import { Popup } from '@syncfusion/ej2-popups';import { BeforeOpenCloseMenuEventArgs, DropDownButton, SplitButton } from '@syncfusion/ej2-splitbuttons';import { CheckBox } from '@syncfusion/ej2-buttons';import { RibbonContextualTab } from '../modules/ribbon-contextualtab';import { RibbonGallery } from '../items/ribbon-gallery';
 import {ComponentModel} from '@syncfusion/ej2-base';
 
 /**
@@ -25,6 +25,20 @@ export interface RibbonModel extends ComponentModel{
      */
     cssClass?: string;
 
+    /**
+     * Defines whether to enable the key tip or not.
+     *
+     * @default false
+     */
+    enableKeyTips?: boolean;
+
+    /**
+     * Defines the key tip text for the layoutSwitcher icon.
+     *
+     * @default ''
+     */
+    layoutSwitcherKeyTip?: string;
+
     /**
      * Defines the properties of ribbon file menu.
      *
@@ -82,6 +96,13 @@ export interface RibbonModel extends ComponentModel{
      */
     tabs?: RibbonTabModel[];
 
+    /**
+     * Defines the properties of ribbon contextual tab.
+     *
+     * @default []
+     */
+    contextualTabs?: RibbonContextualTabSettingsModel[];
+
     /**
      * Specifies the width of the ribbon.
      *

package/src/ribbon/base/ribbon.d.ts

@@ -1,12 +1,14 @@
 import { Component, EmitType } from '@syncfusion/ej2-base';
 import { INotifyPropertyChanged, ModuleDeclaration } from '@syncfusion/ej2-base';
 import { Tab, TabAnimationSettingsModel } from '@syncfusion/ej2-navigations';
-import { RibbonTabModel, RibbonGroupModel, RibbonCollectionModel, RibbonItemModel, FileMenuSettingsModel, BackStageMenuModel } from '../models/index';
+import { RibbonTabModel, RibbonGroupModel, RibbonCollectionModel, RibbonItemModel, FileMenuSettingsModel, BackStageMenuModel, RibbonContextualTabSettingsModel } from '../models/index';
 import { RibbonModel } from './ribbon-model';
 import { ExpandCollapseEventArgs, LauncherClickEventArgs, OverflowPopupEventArgs, RibbonLayout, ribbonTooltipData, TabSelectedEventArgs, TabSelectingEventArgs } from './interface';
 import { RibbonButton, RibbonComboBox, RibbonCheckBox, RibbonDropDown, RibbonColorPicker, RibbonSplitButton, RibbonGroupButton } from '../items/index';
-import { RibbonFileMenu, RibbonBackstage } from '../modules/index';
+import { RibbonFileMenu, RibbonBackstage, RibbonKeyTip } from '../modules/index';
 import { DropDownButton } from '@syncfusion/ej2-splitbuttons';
+import { RibbonContextualTab } from '../modules/ribbon-contextualtab';
+import { RibbonGallery } from '../items/ribbon-gallery';
 /**
  * The Ribbon Component is a structured layout to manage tools with tabs and groups.
  */
@@ -28,6 +30,18 @@ export declare class Ribbon extends Component<HTMLElement> implements INotifyPro
      * @default ''
      */
     cssClass: string;
+    /**
+     * Defines whether to enable the key tip or not.
+     *
+     * @default false
+     */
+    enableKeyTips: boolean;
+    /**
+     * Defines the key tip text for the layoutSwitcher icon.
+     *
+     * @default ''
+     */
+    layoutSwitcherKeyTip: string;
     /**
      * Defines the properties of ribbon file menu.
      *
@@ -77,6 +91,12 @@ export declare class Ribbon extends Component<HTMLElement> implements INotifyPro
      * @default []
      */
     tabs: RibbonTabModel[];
+    /**
+     * Defines the properties of ribbon contextual tab.
+     *
+     * @default []
+     */
+    contextualTabs: RibbonContextualTabSettingsModel[];
     /**
      * Specifies the width of the ribbon.
      *
@@ -172,6 +192,10 @@ export declare class Ribbon extends Component<HTMLElement> implements INotifyPro
      * The `ribbonComboBoxModule` is used to create and manipulate combobox in ribbon item.
      */
     ribbonComboBoxModule: RibbonComboBox;
+    /**
+     * The `ribbonGalleryModule` is used to create and manipulate gallery in ribbon item.
+     */
+    ribbonGalleryModule: RibbonGallery;
     /**
      * The `ribbonFileMenuModule` is used to create and manipulate the ribbon file menu.
      */
@@ -184,6 +208,14 @@ export declare class Ribbon extends Component<HTMLElement> implements INotifyPro
      * The `ribbonGroupButtonModule` is used to create and manipulate group button in ribbon item.
      */
     ribbonGroupButtonModule: RibbonGroupButton;
+    /**
+     * The `ribbonContextualTabModule` is used to create and manipulate group button in ribbon item.
+     */
+    ribbonContextualTabModule: RibbonContextualTab;
+    /**
+     * The `ribbonKeytipModule` is used to create and manipulate the ribbon keytip.
+     */
+    ribbonKeyTipModule: RibbonKeyTip;
     private itemIndex;
     private idIndex;
     private isAddRemove;
@@ -197,6 +229,12 @@ export declare class Ribbon extends Component<HTMLElement> implements INotifyPro
     private hiddenElements;
     private hiddenGroups;
     /** @hidden */
+    keysPress: string;
+    /** @hidden */
+    keyTipElements: {
+        [key: string]: object;
+    };
+    /** @hidden */
     overflowDDB: DropDownButton;
     /** @hidden */
     tabsInternal: RibbonTabModel[];
@@ -204,6 +242,8 @@ export declare class Ribbon extends Component<HTMLElement> implements INotifyPro
     tabObj: Tab;
     /** @hidden */
     tooltipData: ribbonTooltipData[];
+    /** @hidden */
+    isKeytipOpen: boolean;
     /**
      * Constructor for creating the widget.
      *
@@ -245,12 +285,19 @@ export declare class Ribbon extends Component<HTMLElement> implements INotifyPro
     private keyActionHandler;
     private handleNavigation;
     private resizeHandler;
+    private mouseEventHandler;
+    private keytipActionHandler;
+    private checkKeyTipPresent;
+    private removeKeytip;
+    private addKeyTip;
     private renderTabs;
     private minimize;
     private toggleLayout;
     private tabCreated;
     private ribbonTabSelected;
+    private updateSelectedState;
     private checkOverflow;
+    private addTabOverflowKeyTip;
     private checkSimplifiedItemShrinking;
     private checkSimplifiedItemExpanding;
     private createSimplfiedOverflow;
@@ -278,6 +325,7 @@ export declare class Ribbon extends Component<HTMLElement> implements INotifyPro
     private getGroupResizeOrder;
     private destroyScroll;
     private clearOverflowDropDown;
+    private isContextualTab;
     private ribbonTabSelecting;
     private createTabItems;
     private renderInitialTab;
@@ -307,7 +355,14 @@ export declare class Ribbon extends Component<HTMLElement> implements INotifyPro
     private removeLauncherIcon;
     private destroyTabItems;
     private destroyFunction;
-    private getItemModuleName;
+    /**
+     * Gets the item module name.
+     *
+     * @param {RibbonItemModel} item - Gets the ribbon item model.
+     * @returns {void}
+     * @hidden
+     */
+    getItemModuleName(item: RibbonItemModel): string;
     private clearOverflowResize;
     /**
      * Refreshes the layout.
@@ -328,14 +383,14 @@ export declare class Ribbon extends Component<HTMLElement> implements INotifyPro
      * @param {string} tabId - The ID of the tab to be shown.
      * @returns {void}
      */
-    showTab(tabId: string): void;
+    showTab(tabId: string, isContextual?: boolean): void;
     /**
      * Hides a specific tab in the ribbon.
      *
      * @param {string} tabId - The ID of the tab to be hidden.
      * @returns {void}
      */
-    hideTab(tabId: string): void;
+    hideTab(tabId: string, isContextual?: boolean): void;
     private showHideTab;
     /**
      * Enables a specific tab in the ribbon.
@@ -518,6 +573,13 @@ export declare class Ribbon extends Component<HTMLElement> implements INotifyPro
      * @returns {void}
      */
     disableItem(itemId: string): void;
+    /**
+     * Gets the Ribbon item model associated with the specified item ID.
+     *
+     * @param {string} itemId - The unique ID of the Ribbon item.
+     * @returns {RibbonItemModel}
+     */
+    getItem(itemId: string): RibbonItemModel;
     private enableDisableItem;
     private unwireEvents;
     destroy(): void;