primereact 8.7.3 → 9.0.0-beta.1

package/ripple/ripple.d.ts

@@ -1,7 +1,35 @@
+/**
+ *
+ * Ripple component adds ripple effect to the host element.
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/ripple)
+ *
+ * @module ripple
+ *
+ */
 import * as React from 'react';
 
+/**
+ * Defines valid properties in Ripple component.
+ * @group Properties
+ */
 export interface RippleProps {
-    children?: React.ReactNode;
+    /**
+     * Used to get the child elements of the component.
+     * @readonly
+     */
+    children?: React.ReactNode | undefined;
 }
 
+/**
+ * **PrimeReact - Ripple**
+ *
+ * _Ripple component adds ripple effect to the host element._
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/ripple/)
+ * --- ---
+ * ![PrimeReact](https://www.primefaces.org/primereact/images/logo-100.png)
+ *
+ * @group Component
+ */
 export declare class Ripple extends React.Component<RippleProps, any> {}

package/row/row.d.ts

@@ -1,9 +1,43 @@
+/**
+ *
+ * Row component is a helper component used to create grouping structures in DataTable.
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/datatable/)
+ *
+ * @module row
+ *
+ */
 import * as React from 'react';
 
+/**
+ * Defines valid properties in Row component.
+ * @group Properties
+ */
 export interface RowProps {
-    style?: React.CSSProperties;
-    className?: string;
-    children?: React.ReactNode;
+    /**
+     * Inline style of the element.
+     */
+    style?: React.CSSProperties | undefined;
+    /**
+     * Style class of the row.
+     */
+    className?: string | undefined;
+    /**
+     * Used to get the child elements of the component.
+     * @readonly
+     */
+    children?: React.ReactNode | undefined;
 }
 
+/**
+ * **PrimeReact - Row**
+ *
+ * _Row component is a helper component used to create grouping structures in DataTable._
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/datatable/)
+ * --- ---
+ * ![PrimeReact](https://www.primefaces.org/primereact/images/logo-100.png)
+ *
+ * @group Component
+ */
 export declare class Row extends React.Component<RowProps, any> {}

package/scrollpanel/scrollpanel.d.ts

@@ -1,12 +1,56 @@
+/**
+ *
+ * ScrollPanel is a cross browser, lightweight and skinnable alternative to native browser scrollbar.
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/scrollpanel/)
+ *
+ * @module scrollpanel
+ *
+ */
 import * as React from 'react';
 
+/**
+ * Defines valid properties in ScrollPanel component. In addition to these, all properties of HTMLDivElement can be used in this component.
+ * @group Properties
+ */
 export interface ScrollPanelProps extends Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, 'ref'> {
-    children?: React.ReactNode;
+    /**
+     * Used to get the child elements of the component.
+     * @readonly
+     */
+    children?: React.ReactNode | undefined;
 }
 
+/**
+ * **PrimeReact - ScrollPanel**
+ *
+ * _ScrollPanel is a cross browser, lightweight and skinnable alternative to native browser scrollbar._
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/scrollpanel/)
+ * --- ---
+ * ![PrimeReact](https://www.primefaces.org/primereact/images/logo-100.png)
+ *
+ * @group Component
+ */
 export declare class ScrollPanel extends React.Component<ScrollPanelProps, any> {
+    /**
+     * Used to get container element.
+     * @return {HTMLDivElement} Container element
+     */
     public getElement(): HTMLDivElement;
+    /**
+     * Used to get content of the scrollpanel.
+     * @return {HTMLDivElement} Content element
+     */
     public getContent(): HTMLDivElement;
+    /**
+     * Used to get horizontal scrollbar of the panel.
+     * @return {HTMLDivElement} Horizontal bar element
+     */
     public getXBar(): HTMLDivElement;
+    /**
+     * Used to get vertical scrollbar of the panel.
+     * @return {HTMLDivElement} Vertical bar element
+     */
     public getYBar(): HTMLDivElement;
 }

package/scrolltop/scrolltop.d.ts

@@ -1,24 +1,84 @@
+/**
+ *
+ * ScrollTop gets displayed after a certain scroll position and used to navigates to the top of the page quickly.
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/scrolltop/)
+ *
+ * @module scrolltop
+ *
+ */
 import * as React from 'react';
 import { CSSTransitionProps } from '../csstransition';
 import { IconType } from '../utils';
 
-type ScrollTopTargetType = 'window' | 'parent';
-
-type ScrollTopScrollBehavior = 'auto' | 'smooth';
-
+/**
+ * Defines valid properties in ScrollTop component.
+ * @group Properties
+ */
 export interface ScrollTopProps {
-    target?: ScrollTopTargetType;
+    /**
+     * Target of the ScrollTop, valid values are "window" and "parent".
+     * @defaultValue window
+     */
+    target?: 'window' | 'parent' | undefined;
+    /**
+     * Defines the threshold value of the vertical scroll position of the target to toggle the visibility.
+     * @defaultValue 400
+     */
     threshold?: number;
+    /**
+     * Icon to display.
+     * @defaultValue pi pi-chevron-up
+     */
     icon?: IconType<ScrollTopProps>;
-    behavior?: ScrollTopScrollBehavior;
-    className?: string;
-    style?: React.CSSProperties;
-    transitionOptions?: CSSTransitionProps;
+    /**
+     * Defines the scrolling behavior, "smooth" adds an animation and "auto" scrolls with a jump.
+     * @defaultValue smooth
+     */
+    behavior?: 'auto' | 'smooth' | undefined;
+    /**
+     * Style class of the component.
+     */
+    className?: string | undefined;
+    /**
+     * Inline style of the component.
+     */
+    style?: React.CSSProperties | undefined;
+    /**
+     * The properties of CSSTransition can be customized, except for "nodeRef" and "in" properties.
+     * @type {CSSTransitionProps}
+     */
+    transitionOptions?: CSSTransitionProps | undefined;
+    /**
+     * Callback to invoke when overlay panel becomes visible.
+     */
     onShow?(): void;
+    /**
+     * 	Callback to invoke when overlay becomes hidden.
+     */
     onHide?(): void;
-    children?: React.ReactNode;
+    /**
+     * Used to get the child elements of the component.
+     * @readonly
+     */
+    children?: React.ReactNode | undefined;
 }
 
+/**
+ * **PrimeReact - ScrollTop**
+ *
+ * _ScrollTop gets displayed after a certain scroll position and used to navigates to the top of the page quickly._
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/scrolltop/)
+ * --- ---
+ * ![PrimeReact](https://www.primefaces.org/primereact/images/logo-100.png)
+ *
+ * @group Component
+ */
 export declare class ScrollTop extends React.Component<ScrollTopProps, any> {
+    /**
+     * Used to get container element.
+     * @return {HTMLButtonElement} Container element
+     */
     public getElement(): HTMLButtonElement;
 }

package/selectbutton/selectbutton.cjs.js

@@ -253,6 +253,9 @@ var SelectButton = /*#__PURE__*/React__namespace.memo( /*#__PURE__*/React__names
   React__namespace.useImperativeHandle(ref, function () {
     return {
       props: props,
+      focus: function focus() {
+        return utils.DomHandler.focusFirstElement(elementRef.current);
+      },
       getElement: function getElement() {
         return elementRef.current;
       }

package/selectbutton/selectbutton.cjs.min.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react"),t=require("primereact/tooltip"),n=require("primereact/utils"),l=require("primereact/ripple");function r(e){if(e&&e.__esModule)return e;var t=Object.create(null);return e&&Object.keys(e).forEach((function(n){if("default"!==n){var l=Object.getOwnPropertyDescriptor(e,n);Object.defineProperty(t,n,l.get?l:{enumerable:!0,get:function(){return e[n]}})}})),t.default=e,Object.freeze(t)}var o=r(e);function a(){return a=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var l in n)Object.prototype.hasOwnProperty.call(n,l)&&(e[l]=n[l])}return e},a.apply(this,arguments)}function i(e,t){(null==t||t>e.length)&&(t=e.length);for(var n=0,l=new Array(t);n<t;n++)l[n]=e[n];return l}function u(e){if(Array.isArray(e))return i(e)}function c(e){if("undefined"!=typeof Symbol&&null!=e[Symbol.iterator]||null!=e["@@iterator"])return Array.from(e)}function s(e,t){if(e){if("string"==typeof e)return i(e,t);var n=Object.prototype.toString.call(e).slice(8,-1);return"Object"===n&&e.constructor&&(n=e.constructor.name),"Map"===n||"Set"===n?Array.from(e):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?i(e,t):void 0}}function p(){throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}function f(e){return u(e)||c(e)||s(e)||p()}function d(e){if(Array.isArray(e))return e}function b(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var l,r,o,a,i=[],u=!0,c=!1;try{if(o=(n=n.call(e)).next,0===t){if(Object(n)!==n)return;u=!1}else for(;!(u=(l=o.call(n)).done)&&(i.push(l.value),i.length!==t);u=!0);}catch(e){c=!0,r=e}finally{try{if(!u&&null!=n.return&&(a=n.return(),Object(a)!==a))return}finally{if(c)throw r}}return i}}function m(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var v=o.memo((function(e){var t,r,a=o.useState(!1),i=(r=2,d(t=a)||b(t,r)||s(t,r)||m()),u=i[1],c=function(t){e.onClick&&e.onClick({originalEvent:t,option:e.option})},p=n.classNames("p-button p-component",{"p-highlight":e.selected,"p-disabled":e.disabled,"p-focus":i[0]},e.className),f=e.template?n.ObjectUtils.getJSXElement(e.template,e.option):o.createElement("span",{className:"p-button-label p-c"},e.label);return o.createElement("div",{className:p,role:"button","aria-label":e.label,"aria-pressed":e.selected,onClick:c,onKeyDown:function(e){32===e.which&&(c(e),e.preventDefault())},tabIndex:e.tabIndex,onFocus:function(){u(!0)},onBlur:function(){u(!1)}},f,!e.disabled&&o.createElement(l.Ripple,null))}));v.displayName="SelectButtonItem";var y=o.memo(o.forwardRef((function(e,l){var r=o.useRef(null),i=function(t){if(!e.disabled&&!s(t.option)){var l=p(t.option);if(!l||e.unselectable){var r,o=c(t.option);if(e.multiple){var a=e.value?f(e.value):[];r=l?a.filter((function(t){return!n.ObjectUtils.equals(t,o,e.dataKey)})):[].concat(f(a),[o])}else r=l?null:o;e.onChange&&e.onChange({originalEvent:t.originalEvent,value:r,stopPropagation:function(){},preventDefault:function(){},target:{name:e.name,id:e.id,value:r}})}}},u=function(t){return e.optionLabel?n.ObjectUtils.resolveFieldData(t,e.optionLabel):t&&void 0!==t.label?t.label:t},c=function(t){return e.optionValue?n.ObjectUtils.resolveFieldData(t,e.optionValue):t&&void 0!==t.value?t.value:t},s=function(t){return e.optionDisabled?n.ObjectUtils.isFunction(e.optionDisabled)?e.optionDisabled(t):n.ObjectUtils.resolveFieldData(t,e.optionDisabled):!(!t||void 0===t.disabled)&&t.disabled},p=function(t){var l=c(t);return e.multiple?!(!e.value||!e.value.length)&&e.value.some((function(t){return n.ObjectUtils.equals(t,l,e.dataKey)})):n.ObjectUtils.equals(e.value,l,e.dataKey)};o.useImperativeHandle(l,(function(){return{props:e,getElement:function(){return r.current}}}));var d=n.ObjectUtils.isNotEmpty(e.tooltip),b=n.ObjectUtils.findDiffKeys(e,y.defaultProps),m=n.classNames("p-selectbutton p-buttonset p-component",e.className),g=e.options&&e.options.length?e.options.map((function(t,n){var l=e.disabled||s(t),r=u(t),a=l?null:0,c=p(t);return o.createElement(v,{key:r+"_"+n,label:r,className:t.className,option:t,onClick:i,template:e.itemTemplate,selected:c,tabIndex:a,disabled:l})})):null;return o.createElement(o.Fragment,null,o.createElement("div",a({ref:r,id:e.id,className:m,style:e.style},b,{role:"group"}),g),d&&o.createElement(t.Tooltip,a({target:r,content:e.tooltip},e.tooltipOptions)))})));y.displayName="SelectButton",y.defaultProps={__TYPE:"SelectButton",id:null,value:null,options:null,optionLabel:null,optionValue:null,optionDisabled:null,tabIndex:null,multiple:!1,unselectable:!0,disabled:!1,style:null,className:null,dataKey:null,tooltip:null,tooltipOptions:null,itemTemplate:null,onChange:null},exports.SelectButton=y;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react"),t=require("primereact/tooltip"),n=require("primereact/utils"),l=require("primereact/ripple");function r(e){if(e&&e.__esModule)return e;var t=Object.create(null);return e&&Object.keys(e).forEach((function(n){if("default"!==n){var l=Object.getOwnPropertyDescriptor(e,n);Object.defineProperty(t,n,l.get?l:{enumerable:!0,get:function(){return e[n]}})}})),t.default=e,Object.freeze(t)}var o=r(e);function a(){return a=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var l in n)Object.prototype.hasOwnProperty.call(n,l)&&(e[l]=n[l])}return e},a.apply(this,arguments)}function i(e,t){(null==t||t>e.length)&&(t=e.length);for(var n=0,l=new Array(t);n<t;n++)l[n]=e[n];return l}function u(e){if(Array.isArray(e))return i(e)}function c(e){if("undefined"!=typeof Symbol&&null!=e[Symbol.iterator]||null!=e["@@iterator"])return Array.from(e)}function s(e,t){if(e){if("string"==typeof e)return i(e,t);var n=Object.prototype.toString.call(e).slice(8,-1);return"Object"===n&&e.constructor&&(n=e.constructor.name),"Map"===n||"Set"===n?Array.from(e):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?i(e,t):void 0}}function p(){throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}function f(e){return u(e)||c(e)||s(e)||p()}function d(e){if(Array.isArray(e))return e}function b(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var l,r,o,a,i=[],u=!0,c=!1;try{if(o=(n=n.call(e)).next,0===t){if(Object(n)!==n)return;u=!1}else for(;!(u=(l=o.call(n)).done)&&(i.push(l.value),i.length!==t);u=!0);}catch(e){c=!0,r=e}finally{try{if(!u&&null!=n.return&&(a=n.return(),Object(a)!==a))return}finally{if(c)throw r}}return i}}function m(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var v=o.memo((function(e){var t,r,a=o.useState(!1),i=(r=2,d(t=a)||b(t,r)||s(t,r)||m()),u=i[1],c=function(t){e.onClick&&e.onClick({originalEvent:t,option:e.option})},p=n.classNames("p-button p-component",{"p-highlight":e.selected,"p-disabled":e.disabled,"p-focus":i[0]},e.className),f=e.template?n.ObjectUtils.getJSXElement(e.template,e.option):o.createElement("span",{className:"p-button-label p-c"},e.label);return o.createElement("div",{className:p,role:"button","aria-label":e.label,"aria-pressed":e.selected,onClick:c,onKeyDown:function(e){32===e.which&&(c(e),e.preventDefault())},tabIndex:e.tabIndex,onFocus:function(){u(!0)},onBlur:function(){u(!1)}},f,!e.disabled&&o.createElement(l.Ripple,null))}));v.displayName="SelectButtonItem";var y=o.memo(o.forwardRef((function(e,l){var r=o.useRef(null),i=function(t){if(!e.disabled&&!s(t.option)){var l=p(t.option);if(!l||e.unselectable){var r,o=c(t.option);if(e.multiple){var a=e.value?f(e.value):[];r=l?a.filter((function(t){return!n.ObjectUtils.equals(t,o,e.dataKey)})):[].concat(f(a),[o])}else r=l?null:o;e.onChange&&e.onChange({originalEvent:t.originalEvent,value:r,stopPropagation:function(){},preventDefault:function(){},target:{name:e.name,id:e.id,value:r}})}}},u=function(t){return e.optionLabel?n.ObjectUtils.resolveFieldData(t,e.optionLabel):t&&void 0!==t.label?t.label:t},c=function(t){return e.optionValue?n.ObjectUtils.resolveFieldData(t,e.optionValue):t&&void 0!==t.value?t.value:t},s=function(t){return e.optionDisabled?n.ObjectUtils.isFunction(e.optionDisabled)?e.optionDisabled(t):n.ObjectUtils.resolveFieldData(t,e.optionDisabled):!(!t||void 0===t.disabled)&&t.disabled},p=function(t){var l=c(t);return e.multiple?!(!e.value||!e.value.length)&&e.value.some((function(t){return n.ObjectUtils.equals(t,l,e.dataKey)})):n.ObjectUtils.equals(e.value,l,e.dataKey)};o.useImperativeHandle(l,(function(){return{props:e,focus:function(){return n.DomHandler.focusFirstElement(r.current)},getElement:function(){return r.current}}}));var d=n.ObjectUtils.isNotEmpty(e.tooltip),b=n.ObjectUtils.findDiffKeys(e,y.defaultProps),m=n.classNames("p-selectbutton p-buttonset p-component",e.className),g=e.options&&e.options.length?e.options.map((function(t,n){var l=e.disabled||s(t),r=u(t),a=l?null:0,c=p(t);return o.createElement(v,{key:r+"_"+n,label:r,className:t.className,option:t,onClick:i,template:e.itemTemplate,selected:c,tabIndex:a,disabled:l})})):null;return o.createElement(o.Fragment,null,o.createElement("div",a({ref:r,id:e.id,className:m,style:e.style},b,{role:"group"}),g),d&&o.createElement(t.Tooltip,a({target:r,content:e.tooltip},e.tooltipOptions)))})));y.displayName="SelectButton",y.defaultProps={__TYPE:"SelectButton",id:null,value:null,options:null,optionLabel:null,optionValue:null,optionDisabled:null,tabIndex:null,multiple:!1,unselectable:!0,disabled:!1,style:null,className:null,dataKey:null,tooltip:null,tooltipOptions:null,itemTemplate:null,onChange:null},exports.SelectButton=y;

package/selectbutton/selectbutton.d.ts

@@ -1,42 +1,121 @@
+/**
+ *
+ * SelectButton is used to choose single or multiple items from a list using buttons.
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/selectbutton/)
+ *
+ * @module selectbutton
+ *
+ */
 import * as React from 'react';
-import TooltipOptions from '../tooltip/tooltipoptions';
 import { SelectItemOptionsType } from '../selectitem/selectitem';
+import { TooltipOptions } from '../tooltip/tooltipoptions';
+import { FormEvent } from '../ts-helpers';
 
-type SelectButtonOptionDisabledType = string | ((option: any) => boolean);
-
-interface SelectButtonChangeTargetOptions {
-    name: string;
-    id: string;
-    value: any;
-}
-
-interface SelectButtonChangeParams {
-    originalEvent: React.SyntheticEvent;
-    value: any;
-    stopPropagation(): void;
-    preventDefault(): void;
-    target: SelectButtonChangeTargetOptions;
-}
+/**
+ * Custom change event.
+ * @see {@link SelectButtonProps.onChange}
+ * @extends {FormEvent}
+ * @event
+ */
+interface SelectButtonChangeEvent extends FormEvent {}
 
+/**
+ * Defines valid properties in SelectButton component. In addition to these, all properties of HTMLDivElement can be used in this component.
+ * @group Properties
+ */
 export interface SelectButtonProps extends Omit<React.DetailedHTMLProps<React.InputHTMLAttributes<HTMLDivElement>, HTMLDivElement>, 'unselectable' | 'onChange' | 'ref'> {
-    value?: any;
-    options?: SelectItemOptionsType;
-    optionLabel?: string;
-    optionValue?: string;
-    optionDisabled?: SelectButtonOptionDisabledType;
-    tabIndex?: number;
-    multiple?: boolean;
-    unselectable?: boolean;
-    disabled?: boolean;
-    dataKey?: string;
-    tooltip?: string;
-    tooltipOptions?: TooltipOptions;
-    ariaLabelledBy?: string;
-    itemTemplate?(option: any): React.ReactNode;
-    onChange?(e: SelectButtonChangeParams): void;
-    children?: React.ReactNode;
+    /**
+     * Value of the component.
+     */
+    value?: any | undefined;
+    /**
+     * An array of objects to display as the available options.
+     */
+    options?: SelectItemOptionsType | undefined;
+    /**
+     * Name of the label field of an option when an arbitrary objects instead of SelectItems are used as options.
+     */
+    optionLabel?: string | undefined;
+    /**
+     * Name of the value field of an option when arbitrary objects are used as options instead of SelectItems.
+     */
+    optionValue?: string | undefined;
+    /**
+     * Property name or getter function to use as the disabled flag of an option, defaults to false when not defined.
+     */
+    optionDisabled?: string | ((option: any) => boolean);
+    /**
+     * Index of the element in tabbing order.
+     */
+    tabIndex?: number | undefined;
+    /**
+     * When specified, allows selecting multiple values.
+     * @defaultValue false
+     */
+    multiple?: boolean | undefined;
+    /**
+     * Whether selection can be cleared.
+     * @defaultValue true
+     */
+    unselectable?: boolean | undefined;
+    /**
+     * When present, it specifies that the element should be disabled.
+     * @defaultValue false
+     */
+    disabled?: boolean | undefined;
+    /**
+     * A property to uniquely match the value in options for better performance.
+     */
+    dataKey?: string | undefined;
+    /**
+     * Content of the tooltip.
+     */
+    tooltip?: string | undefined;
+    /**
+     * Configuration of the tooltip, refer to the tooltip documentation for more information.
+     */
+    tooltipOptions?: TooltipOptions | undefined;
+    /**
+     * Establishes relationships between the component and label(s) where its value should be one or more element IDs.
+     */
+    ariaLabelledBy?: string | undefined;
+    /**
+     * Function that gets the option and returns the content.
+     * @param {*} item - Current item
+     */
+    itemTemplate?(item: any): React.ReactNode;
+    /**
+     * Callback to invoke on value change.
+     * @param {SelectButtonChangeEvent} event - Custom change event.
+     */
+    onChange?(event: SelectButtonChangeEvent): void;
+    /**
+     * Used to get the child elements of the component.
+     * @readonly
+     */
+    children?: React.ReactNode | undefined;
 }
 
+/**
+ * **PrimeReact - SelectButton**
+ *
+ * _SelectButton is used to choose single or multiple items from a list using buttons._
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/selectbutton/)
+ * --- ---
+ * ![PrimeReact](https://www.primefaces.org/primereact/images/logo-100.png)
+ *
+ * @group Component
+ */
 export declare class SelectButton extends React.Component<SelectButtonProps, any> {
+    /**
+     * Used to get container element.
+     * @return {HTMLDivElement} Container element
+     */
     public getElement(): HTMLDivElement;
+    /**
+     * Used to focus the component.
+     */
+    public focus(): void;
 }

package/selectbutton/selectbutton.esm.js

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import { Tooltip } from 'primereact/tooltip';
-import { classNames, ObjectUtils } from 'primereact/utils';
+import { classNames, ObjectUtils, DomHandler } from 'primereact/utils';
 import { Ripple } from 'primereact/ripple';
 
 function _extends() {
@@ -229,6 +229,9 @@ var SelectButton = /*#__PURE__*/React.memo( /*#__PURE__*/React.forwardRef(functi
   React.useImperativeHandle(ref, function () {
     return {
       props: props,
+      focus: function focus() {
+        return DomHandler.focusFirstElement(elementRef.current);
+      },
       getElement: function getElement() {
         return elementRef.current;
       }

package/selectbutton/selectbutton.esm.min.js

@@ -1 +1 @@
-import*as e from"react";import{Tooltip as t}from"primereact/tooltip";import{classNames as n,ObjectUtils as l}from"primereact/utils";import{Ripple as o}from"primereact/ripple";function a(){return a=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var l in n)Object.prototype.hasOwnProperty.call(n,l)&&(e[l]=n[l])}return e},a.apply(this,arguments)}function r(e,t){(null==t||t>e.length)&&(t=e.length);for(var n=0,l=new Array(t);n<t;n++)l[n]=e[n];return l}function i(e){if(Array.isArray(e))return r(e)}function u(e){if("undefined"!=typeof Symbol&&null!=e[Symbol.iterator]||null!=e["@@iterator"])return Array.from(e)}function s(e,t){if(e){if("string"==typeof e)return r(e,t);var n=Object.prototype.toString.call(e).slice(8,-1);return"Object"===n&&e.constructor&&(n=e.constructor.name),"Map"===n||"Set"===n?Array.from(e):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?r(e,t):void 0}}function c(){throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}function p(e){return i(e)||u(e)||s(e)||c()}function f(e){if(Array.isArray(e))return e}function d(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var l,o,a,r,i=[],u=!0,s=!1;try{if(a=(n=n.call(e)).next,0===t){if(Object(n)!==n)return;u=!1}else for(;!(u=(l=a.call(n)).done)&&(i.push(l.value),i.length!==t);u=!0);}catch(e){s=!0,o=e}finally{try{if(!u&&null!=n.return&&(r=n.return(),Object(r)!==r))return}finally{if(s)throw o}}return i}}function m(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var b=e.memo((function(t){var a,r,i=e.useState(!1),u=(r=2,f(a=i)||d(a,r)||s(a,r)||m()),c=u[1],p=function(e){t.onClick&&t.onClick({originalEvent:e,option:t.option})},b=n("p-button p-component",{"p-highlight":t.selected,"p-disabled":t.disabled,"p-focus":u[0]},t.className),v=t.template?l.getJSXElement(t.template,t.option):e.createElement("span",{className:"p-button-label p-c"},t.label);return e.createElement("div",{className:b,role:"button","aria-label":t.label,"aria-pressed":t.selected,onClick:p,onKeyDown:function(e){32===e.which&&(p(e),e.preventDefault())},tabIndex:t.tabIndex,onFocus:function(){c(!0)},onBlur:function(){c(!1)}},v,!t.disabled&&e.createElement(o,null))}));b.displayName="SelectButtonItem";var v=e.memo(e.forwardRef((function(o,r){var i=e.useRef(null),u=function(e){if(!o.disabled&&!f(e.option)){var t=d(e.option);if(!t||o.unselectable){var n,a=c(e.option);if(o.multiple){var r=o.value?p(o.value):[];n=t?r.filter((function(e){return!l.equals(e,a,o.dataKey)})):[].concat(p(r),[a])}else n=t?null:a;o.onChange&&o.onChange({originalEvent:e.originalEvent,value:n,stopPropagation:function(){},preventDefault:function(){},target:{name:o.name,id:o.id,value:n}})}}},s=function(e){return o.optionLabel?l.resolveFieldData(e,o.optionLabel):e&&void 0!==e.label?e.label:e},c=function(e){return o.optionValue?l.resolveFieldData(e,o.optionValue):e&&void 0!==e.value?e.value:e},f=function(e){return o.optionDisabled?l.isFunction(o.optionDisabled)?o.optionDisabled(e):l.resolveFieldData(e,o.optionDisabled):!(!e||void 0===e.disabled)&&e.disabled},d=function(e){var t=c(e);return o.multiple?!(!o.value||!o.value.length)&&o.value.some((function(e){return l.equals(e,t,o.dataKey)})):l.equals(o.value,t,o.dataKey)};e.useImperativeHandle(r,(function(){return{props:o,getElement:function(){return i.current}}}));var m=l.isNotEmpty(o.tooltip),y=l.findDiffKeys(o,v.defaultProps),g=n("p-selectbutton p-buttonset p-component",o.className),h=o.options&&o.options.length?o.options.map((function(t,n){var l=o.disabled||f(t),a=s(t),r=l?null:0,i=d(t);return e.createElement(b,{key:a+"_"+n,label:a,className:t.className,option:t,onClick:u,template:o.itemTemplate,selected:i,tabIndex:r,disabled:l})})):null;return e.createElement(e.Fragment,null,e.createElement("div",a({ref:i,id:o.id,className:g,style:o.style},y,{role:"group"}),h),m&&e.createElement(t,a({target:i,content:o.tooltip},o.tooltipOptions)))})));v.displayName="SelectButton",v.defaultProps={__TYPE:"SelectButton",id:null,value:null,options:null,optionLabel:null,optionValue:null,optionDisabled:null,tabIndex:null,multiple:!1,unselectable:!0,disabled:!1,style:null,className:null,dataKey:null,tooltip:null,tooltipOptions:null,itemTemplate:null,onChange:null};export{v as SelectButton};
+import*as e from"react";import{Tooltip as t}from"primereact/tooltip";import{classNames as n,ObjectUtils as l,DomHandler as o}from"primereact/utils";import{Ripple as r}from"primereact/ripple";function a(){return a=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var l in n)Object.prototype.hasOwnProperty.call(n,l)&&(e[l]=n[l])}return e},a.apply(this,arguments)}function i(e,t){(null==t||t>e.length)&&(t=e.length);for(var n=0,l=new Array(t);n<t;n++)l[n]=e[n];return l}function u(e){if(Array.isArray(e))return i(e)}function s(e){if("undefined"!=typeof Symbol&&null!=e[Symbol.iterator]||null!=e["@@iterator"])return Array.from(e)}function c(e,t){if(e){if("string"==typeof e)return i(e,t);var n=Object.prototype.toString.call(e).slice(8,-1);return"Object"===n&&e.constructor&&(n=e.constructor.name),"Map"===n||"Set"===n?Array.from(e):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?i(e,t):void 0}}function p(){throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}function f(e){return u(e)||s(e)||c(e)||p()}function m(e){if(Array.isArray(e))return e}function d(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var l,o,r,a,i=[],u=!0,s=!1;try{if(r=(n=n.call(e)).next,0===t){if(Object(n)!==n)return;u=!1}else for(;!(u=(l=r.call(n)).done)&&(i.push(l.value),i.length!==t);u=!0);}catch(e){s=!0,o=e}finally{try{if(!u&&null!=n.return&&(a=n.return(),Object(a)!==a))return}finally{if(s)throw o}}return i}}function b(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var v=e.memo((function(t){var o,a,i=e.useState(!1),u=(a=2,m(o=i)||d(o,a)||c(o,a)||b()),s=u[1],p=function(e){t.onClick&&t.onClick({originalEvent:e,option:t.option})},f=n("p-button p-component",{"p-highlight":t.selected,"p-disabled":t.disabled,"p-focus":u[0]},t.className),v=t.template?l.getJSXElement(t.template,t.option):e.createElement("span",{className:"p-button-label p-c"},t.label);return e.createElement("div",{className:f,role:"button","aria-label":t.label,"aria-pressed":t.selected,onClick:p,onKeyDown:function(e){32===e.which&&(p(e),e.preventDefault())},tabIndex:t.tabIndex,onFocus:function(){s(!0)},onBlur:function(){s(!1)}},v,!t.disabled&&e.createElement(r,null))}));v.displayName="SelectButtonItem";var y=e.memo(e.forwardRef((function(r,i){var u=e.useRef(null),s=function(e){if(!r.disabled&&!m(e.option)){var t=d(e.option);if(!t||r.unselectable){var n,o=p(e.option);if(r.multiple){var a=r.value?f(r.value):[];n=t?a.filter((function(e){return!l.equals(e,o,r.dataKey)})):[].concat(f(a),[o])}else n=t?null:o;r.onChange&&r.onChange({originalEvent:e.originalEvent,value:n,stopPropagation:function(){},preventDefault:function(){},target:{name:r.name,id:r.id,value:n}})}}},c=function(e){return r.optionLabel?l.resolveFieldData(e,r.optionLabel):e&&void 0!==e.label?e.label:e},p=function(e){return r.optionValue?l.resolveFieldData(e,r.optionValue):e&&void 0!==e.value?e.value:e},m=function(e){return r.optionDisabled?l.isFunction(r.optionDisabled)?r.optionDisabled(e):l.resolveFieldData(e,r.optionDisabled):!(!e||void 0===e.disabled)&&e.disabled},d=function(e){var t=p(e);return r.multiple?!(!r.value||!r.value.length)&&r.value.some((function(e){return l.equals(e,t,r.dataKey)})):l.equals(r.value,t,r.dataKey)};e.useImperativeHandle(i,(function(){return{props:r,focus:function(){return o.focusFirstElement(u.current)},getElement:function(){return u.current}}}));var b=l.isNotEmpty(r.tooltip),g=l.findDiffKeys(r,y.defaultProps),h=n("p-selectbutton p-buttonset p-component",r.className),E=r.options&&r.options.length?r.options.map((function(t,n){var l=r.disabled||m(t),o=c(t),a=l?null:0,i=d(t);return e.createElement(v,{key:o+"_"+n,label:o,className:t.className,option:t,onClick:s,template:r.itemTemplate,selected:i,tabIndex:a,disabled:l})})):null;return e.createElement(e.Fragment,null,e.createElement("div",a({ref:u,id:r.id,className:h,style:r.style},g,{role:"group"}),E),b&&e.createElement(t,a({target:u,content:r.tooltip},r.tooltipOptions)))})));y.displayName="SelectButton",y.defaultProps={__TYPE:"SelectButton",id:null,value:null,options:null,optionLabel:null,optionValue:null,optionDisabled:null,tabIndex:null,multiple:!1,unselectable:!0,disabled:!1,style:null,className:null,dataKey:null,tooltip:null,tooltipOptions:null,itemTemplate:null,onChange:null};export{y as SelectButton};

package/selectbutton/selectbutton.js

@@ -248,6 +248,9 @@ this.primereact.selectbutton = (function (exports, React, tooltip, utils, ripple
     React__namespace.useImperativeHandle(ref, function () {
       return {
         props: props,
+        focus: function focus() {
+          return utils.DomHandler.focusFirstElement(elementRef.current);
+        },
         getElement: function getElement() {
           return elementRef.current;
         }

package/selectbutton/selectbutton.min.js

@@ -1 +1 @@
-this.primereact=this.primereact||{},this.primereact.selectbutton=function(e,t,n,l,r){"use strict";function a(e){if(e&&e.__esModule)return e;var t=Object.create(null);return e&&Object.keys(e).forEach((function(n){if("default"!==n){var l=Object.getOwnPropertyDescriptor(e,n);Object.defineProperty(t,n,l.get?l:{enumerable:!0,get:function(){return e[n]}})}})),t.default=e,Object.freeze(t)}var o=a(t);function i(){return i=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var l in n)Object.prototype.hasOwnProperty.call(n,l)&&(e[l]=n[l])}return e},i.apply(this,arguments)}function u(e,t){(null==t||t>e.length)&&(t=e.length);for(var n=0,l=new Array(t);n<t;n++)l[n]=e[n];return l}function c(e){if(Array.isArray(e))return u(e)}function s(e){if("undefined"!=typeof Symbol&&null!=e[Symbol.iterator]||null!=e["@@iterator"])return Array.from(e)}function p(e,t){if(e){if("string"==typeof e)return u(e,t);var n=Object.prototype.toString.call(e).slice(8,-1);return"Object"===n&&e.constructor&&(n=e.constructor.name),"Map"===n||"Set"===n?Array.from(e):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?u(e,t):void 0}}function f(){throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}function d(e){return c(e)||s(e)||p(e)||f()}function b(e){if(Array.isArray(e))return e}function m(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var l,r,a,o,i=[],u=!0,c=!1;try{if(a=(n=n.call(e)).next,0===t){if(Object(n)!==n)return;u=!1}else for(;!(u=(l=a.call(n)).done)&&(i.push(l.value),i.length!==t);u=!0);}catch(e){c=!0,r=e}finally{try{if(!u&&null!=n.return&&(o=n.return(),Object(o)!==o))return}finally{if(c)throw r}}return i}}function v(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var y=o.memo((function(e){var t,n,a=o.useState(!1),i=(n=2,b(t=a)||m(t,n)||p(t,n)||v()),u=i[1],c=function(t){e.onClick&&e.onClick({originalEvent:t,option:e.option})},s=l.classNames("p-button p-component",{"p-highlight":e.selected,"p-disabled":e.disabled,"p-focus":i[0]},e.className),f=e.template?l.ObjectUtils.getJSXElement(e.template,e.option):o.createElement("span",{className:"p-button-label p-c"},e.label);return o.createElement("div",{className:s,role:"button","aria-label":e.label,"aria-pressed":e.selected,onClick:c,onKeyDown:function(e){32===e.which&&(c(e),e.preventDefault())},tabIndex:e.tabIndex,onFocus:function(){u(!0)},onBlur:function(){u(!1)}},f,!e.disabled&&o.createElement(r.Ripple,null))}));y.displayName="SelectButtonItem";var g=o.memo(o.forwardRef((function(e,t){var r=o.useRef(null),a=function(t){if(!e.disabled&&!s(t.option)){var n=p(t.option);if(!n||e.unselectable){var r,a=c(t.option);if(e.multiple){var o=e.value?d(e.value):[];r=n?o.filter((function(t){return!l.ObjectUtils.equals(t,a,e.dataKey)})):[].concat(d(o),[a])}else r=n?null:a;e.onChange&&e.onChange({originalEvent:t.originalEvent,value:r,stopPropagation:function(){},preventDefault:function(){},target:{name:e.name,id:e.id,value:r}})}}},u=function(t){return e.optionLabel?l.ObjectUtils.resolveFieldData(t,e.optionLabel):t&&void 0!==t.label?t.label:t},c=function(t){return e.optionValue?l.ObjectUtils.resolveFieldData(t,e.optionValue):t&&void 0!==t.value?t.value:t},s=function(t){return e.optionDisabled?l.ObjectUtils.isFunction(e.optionDisabled)?e.optionDisabled(t):l.ObjectUtils.resolveFieldData(t,e.optionDisabled):!(!t||void 0===t.disabled)&&t.disabled},p=function(t){var n=c(t);return e.multiple?!(!e.value||!e.value.length)&&e.value.some((function(t){return l.ObjectUtils.equals(t,n,e.dataKey)})):l.ObjectUtils.equals(e.value,n,e.dataKey)};o.useImperativeHandle(t,(function(){return{props:e,getElement:function(){return r.current}}}));var f=l.ObjectUtils.isNotEmpty(e.tooltip),b=l.ObjectUtils.findDiffKeys(e,g.defaultProps),m=l.classNames("p-selectbutton p-buttonset p-component",e.className),v=e.options&&e.options.length?e.options.map((function(t,n){var l=e.disabled||s(t),r=u(t),i=l?null:0,c=p(t);return o.createElement(y,{key:r+"_"+n,label:r,className:t.className,option:t,onClick:a,template:e.itemTemplate,selected:c,tabIndex:i,disabled:l})})):null;return o.createElement(o.Fragment,null,o.createElement("div",i({ref:r,id:e.id,className:m,style:e.style},b,{role:"group"}),v),f&&o.createElement(n.Tooltip,i({target:r,content:e.tooltip},e.tooltipOptions)))})));return g.displayName="SelectButton",g.defaultProps={__TYPE:"SelectButton",id:null,value:null,options:null,optionLabel:null,optionValue:null,optionDisabled:null,tabIndex:null,multiple:!1,unselectable:!0,disabled:!1,style:null,className:null,dataKey:null,tooltip:null,tooltipOptions:null,itemTemplate:null,onChange:null},e.SelectButton=g,Object.defineProperty(e,"__esModule",{value:!0}),e}({},React,primereact.tooltip,primereact.utils,primereact.ripple);
+this.primereact=this.primereact||{},this.primereact.selectbutton=function(e,t,n,l,r){"use strict";function o(e){if(e&&e.__esModule)return e;var t=Object.create(null);return e&&Object.keys(e).forEach((function(n){if("default"!==n){var l=Object.getOwnPropertyDescriptor(e,n);Object.defineProperty(t,n,l.get?l:{enumerable:!0,get:function(){return e[n]}})}})),t.default=e,Object.freeze(t)}var a=o(t);function i(){return i=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var l in n)Object.prototype.hasOwnProperty.call(n,l)&&(e[l]=n[l])}return e},i.apply(this,arguments)}function u(e,t){(null==t||t>e.length)&&(t=e.length);for(var n=0,l=new Array(t);n<t;n++)l[n]=e[n];return l}function c(e){if(Array.isArray(e))return u(e)}function s(e){if("undefined"!=typeof Symbol&&null!=e[Symbol.iterator]||null!=e["@@iterator"])return Array.from(e)}function p(e,t){if(e){if("string"==typeof e)return u(e,t);var n=Object.prototype.toString.call(e).slice(8,-1);return"Object"===n&&e.constructor&&(n=e.constructor.name),"Map"===n||"Set"===n?Array.from(e):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?u(e,t):void 0}}function f(){throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}function d(e){return c(e)||s(e)||p(e)||f()}function b(e){if(Array.isArray(e))return e}function m(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var l,r,o,a,i=[],u=!0,c=!1;try{if(o=(n=n.call(e)).next,0===t){if(Object(n)!==n)return;u=!1}else for(;!(u=(l=o.call(n)).done)&&(i.push(l.value),i.length!==t);u=!0);}catch(e){c=!0,r=e}finally{try{if(!u&&null!=n.return&&(a=n.return(),Object(a)!==a))return}finally{if(c)throw r}}return i}}function v(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var y=a.memo((function(e){var t,n,o=a.useState(!1),i=(n=2,b(t=o)||m(t,n)||p(t,n)||v()),u=i[1],c=function(t){e.onClick&&e.onClick({originalEvent:t,option:e.option})},s=l.classNames("p-button p-component",{"p-highlight":e.selected,"p-disabled":e.disabled,"p-focus":i[0]},e.className),f=e.template?l.ObjectUtils.getJSXElement(e.template,e.option):a.createElement("span",{className:"p-button-label p-c"},e.label);return a.createElement("div",{className:s,role:"button","aria-label":e.label,"aria-pressed":e.selected,onClick:c,onKeyDown:function(e){32===e.which&&(c(e),e.preventDefault())},tabIndex:e.tabIndex,onFocus:function(){u(!0)},onBlur:function(){u(!1)}},f,!e.disabled&&a.createElement(r.Ripple,null))}));y.displayName="SelectButtonItem";var g=a.memo(a.forwardRef((function(e,t){var r=a.useRef(null),o=function(t){if(!e.disabled&&!s(t.option)){var n=p(t.option);if(!n||e.unselectable){var r,o=c(t.option);if(e.multiple){var a=e.value?d(e.value):[];r=n?a.filter((function(t){return!l.ObjectUtils.equals(t,o,e.dataKey)})):[].concat(d(a),[o])}else r=n?null:o;e.onChange&&e.onChange({originalEvent:t.originalEvent,value:r,stopPropagation:function(){},preventDefault:function(){},target:{name:e.name,id:e.id,value:r}})}}},u=function(t){return e.optionLabel?l.ObjectUtils.resolveFieldData(t,e.optionLabel):t&&void 0!==t.label?t.label:t},c=function(t){return e.optionValue?l.ObjectUtils.resolveFieldData(t,e.optionValue):t&&void 0!==t.value?t.value:t},s=function(t){return e.optionDisabled?l.ObjectUtils.isFunction(e.optionDisabled)?e.optionDisabled(t):l.ObjectUtils.resolveFieldData(t,e.optionDisabled):!(!t||void 0===t.disabled)&&t.disabled},p=function(t){var n=c(t);return e.multiple?!(!e.value||!e.value.length)&&e.value.some((function(t){return l.ObjectUtils.equals(t,n,e.dataKey)})):l.ObjectUtils.equals(e.value,n,e.dataKey)};a.useImperativeHandle(t,(function(){return{props:e,focus:function(){return l.DomHandler.focusFirstElement(r.current)},getElement:function(){return r.current}}}));var f=l.ObjectUtils.isNotEmpty(e.tooltip),b=l.ObjectUtils.findDiffKeys(e,g.defaultProps),m=l.classNames("p-selectbutton p-buttonset p-component",e.className),v=e.options&&e.options.length?e.options.map((function(t,n){var l=e.disabled||s(t),r=u(t),i=l?null:0,c=p(t);return a.createElement(y,{key:r+"_"+n,label:r,className:t.className,option:t,onClick:o,template:e.itemTemplate,selected:c,tabIndex:i,disabled:l})})):null;return a.createElement(a.Fragment,null,a.createElement("div",i({ref:r,id:e.id,className:m,style:e.style},b,{role:"group"}),v),f&&a.createElement(n.Tooltip,i({target:r,content:e.tooltip},e.tooltipOptions)))})));return g.displayName="SelectButton",g.defaultProps={__TYPE:"SelectButton",id:null,value:null,options:null,optionLabel:null,optionValue:null,optionDisabled:null,tabIndex:null,multiple:!1,unselectable:!0,disabled:!1,style:null,className:null,dataKey:null,tooltip:null,tooltipOptions:null,itemTemplate:null,onChange:null},e.SelectButton=g,Object.defineProperty(e,"__esModule",{value:!0}),e}({},React,primereact.tooltip,primereact.utils,primereact.ripple);

package/selectitem/selectitem.d.ts

@@ -1,12 +1,46 @@
+/**
+ *
+ * This module contains the interface and types for options in a select component.
+ *
+ * @module selectitem
+ *
+ */
 import { IconType } from '../utils';
 
+/**
+ * Custom options type.
+ * @group Misc
+ */
 export type SelectItemOptionsType = SelectItem[] | any[];
 
+/**
+ * Defines valid properties in SelectItem component.
+ * @group Properties
+ */
 export interface SelectItem {
+    /**
+     * Label of the option.
+     */
     label?: string;
+    /**
+     * Value of the option.
+     */
     value?: any;
+    /**
+     * ClassName of the option.
+     */
     className?: string;
+    /**
+     * Icon to display to the option.
+     */
     icon?: IconType<SelectItem>;
+    /**
+     * Tooltip text of the option. (Not supported)
+     */
     title?: string;
+    /**
+     * Whether the option is disabled or not. (Not supported)
+     * @defaultValue false
+     */
     disabled?: boolean;
 }

package/sidebar/sidebar.cjs.js

@@ -239,6 +239,15 @@ var Sidebar = /*#__PURE__*/React__namespace.forwardRef(function (props, ref) {
       setVisibleState(true);
     }
   }, [maskVisibleState]);
+  hooks.useUpdateEffect(function () {
+    // #3811 if dismissible state is toggled while open we must unregister and re-regisetr
+    if (visibleState) {
+      unbindDocumentClickListener();
+      if (props.dismissable && !props.modal) {
+        bindDocumentClickListener();
+      }
+    }
+  }, [props.dismissable, props.modal, visibleState]);
   hooks.useUnmountEffect(function () {
     disableDocumentSettings();
     maskRef.current && utils.ZIndexUtils.clear(maskRef.current);
@@ -264,7 +273,10 @@ var Sidebar = /*#__PURE__*/React__namespace.forwardRef(function (props, ref) {
   };
   var createElement = function createElement() {
     var otherProps = utils.ObjectUtils.findDiffKeys(props, Sidebar.defaultProps);
-    var className = utils.classNames('p-sidebar p-component', props.className);
+    var className = utils.classNames('p-sidebar p-component', props.className, {
+      'p-input-filled': PrimeReact__default["default"].inputStyle === 'filled',
+      'p-ripple-disabled': PrimeReact__default["default"].ripple === false
+    });
     var maskClassName = utils.classNames('p-sidebar-mask', {
       'p-component-overlay p-component-overlay-enter': props.modal,
       'p-sidebar-mask-scrollblocker': props.blockScroll,

package/sidebar/sidebar.cjs.min.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react"),t=require("primereact/api"),n=require("primereact/csstransition"),r=require("primereact/hooks"),l=require("primereact/portal"),o=require("primereact/ripple"),a=require("primereact/utils");function i(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}function s(e){if(e&&e.__esModule)return e;var t=Object.create(null);return e&&Object.keys(e).forEach((function(n){if("default"!==n){var r=Object.getOwnPropertyDescriptor(e,n);Object.defineProperty(t,n,r.get?r:{enumerable:!0,get:function(){return e[n]}})}})),t.default=e,Object.freeze(t)}var c=s(e),u=i(t);function d(){return d=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e},d.apply(this,arguments)}function f(e){if(Array.isArray(e))return e}function p(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var r,l,o,a,i=[],s=!0,c=!1;try{if(o=(n=n.call(e)).next,0===t){if(Object(n)!==n)return;s=!1}else for(;!(s=(r=o.call(n)).done)&&(i.push(r.value),i.length!==t);s=!0);}catch(e){c=!0,l=e}finally{try{if(!s&&null!=n.return&&(a=n.return(),Object(a)!==a))return}finally{if(c)throw l}}return i}}function m(e,t){(null==t||t>e.length)&&(t=e.length);for(var n=0,r=new Array(t);n<t;n++)r[n]=e[n];return r}function b(e,t){if(e){if("string"==typeof e)return m(e,t);var n=Object.prototype.toString.call(e).slice(8,-1);return"Object"===n&&e.constructor&&(n=e.constructor.name),"Map"===n||"Set"===n?Array.from(e):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?m(e,t):void 0}}function v(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}function y(e,t){return f(e)||p(e,t)||b(e,t)||v()}var h=c.forwardRef((function(e,i){var s=y(c.useState(!1),2),f=s[0],p=s[1],m=y(c.useState(!1),2),b=m[0],v=m[1],E=c.useRef(null),S=c.useRef(null),O=c.useRef(null),g=y(r.useEventListener({type:"keydown",listener:function(e){27===e.which&&a.ZIndexUtils.get(S.current)===a.ZIndexUtils.getCurrent("modal",u.default.autoZIndex)&&U(e)}}),2),w=g[0],k=g[1],I=y(r.useEventListener({type:"click",listener:function(e){2!==e.which&&C(e)&&U(e)}}),2),j=I[0],x=I[1],C=function(e){return E&&E.current&&!E.current.contains(e.target)},N=function(t){e.dismissable&&e.modal&&S.current===t.target&&U(t)},U=function(t){e.onHide(),t.preventDefault()},Z=function(){var t;e.onShow&&e.onShow(),!((t=document.activeElement)&&E&&E.current.contains(t))&&e.showCloseIcon&&O.current.focus(),D()},P=function(){e.modal&&a.DomHandler.addClass(S.current,"p-component-overlay-leave")},q=function(){a.ZIndexUtils.clear(S.current),p(!1),A()},D=function(){e.closeOnEscape&&w(),e.dismissable&&!e.modal&&j(),e.blockScroll&&a.DomHandler.addClass(document.body,"p-overflow-hidden")},A=function(){k(),x(),e.blockScroll&&a.DomHandler.removeClass(document.body,"p-overflow-hidden")};c.useImperativeHandle(i,(function(){return{props:e,getElement:function(){return E.current},gteMask:function(){return S.current},getCloseIcon:function(){return O.current}}})),r.useMountEffect((function(){e.visible&&p(!0)})),r.useUpdateEffect((function(){e.visible&&!f&&p(!0),e.visible!==b&&f&&v(e.visible)})),r.useUpdateEffect((function(){f&&(a.ZIndexUtils.set("modal",S.current,u.default.autoZIndex,e.baseZIndex||u.default.zIndex.modal),v(!0))}),[f]),r.useUnmountEffect((function(){A(),S.current&&a.ZIndexUtils.clear(S.current)}));var H,M,R,T,_,L,z,J=function(){if(e.showCloseIcon){var n=e.ariaCloseLabel||t.localeOption("close");return c.createElement("button",{type:"button",ref:O,className:"p-sidebar-close p-sidebar-icon p-link",onClick:U,"aria-label":n},c.createElement("span",{className:"p-sidebar-close-icon pi pi-times","aria-hidden":"true"}),c.createElement(o.Ripple,null))}return null};return f&&(M=a.ObjectUtils.findDiffKeys(e,h.defaultProps),R=a.classNames("p-sidebar p-component",e.className),T=a.classNames("p-sidebar-mask",{"p-component-overlay p-component-overlay-enter":e.modal,"p-sidebar-mask-scrollblocker":e.blockScroll,"p-sidebar-visible":f,"p-sidebar-full":e.fullScreen},(H=["left","right","top","bottom"].find((function(t){return t===e.position})))?"p-sidebar-".concat(H):"",e.maskClassName),_=J(),L=e.icons?a.ObjectUtils.getJSXElement(e.icons,e):null,z=c.createElement("div",{ref:S,style:e.maskStyle,className:T,onMouseDown:N},c.createElement(n.CSSTransition,{nodeRef:E,classNames:"p-sidebar",in:b,timeout:{enter:e.fullScreen?150:300,exit:e.fullScreen?150:300},options:e.transitionOptions,unmountOnExit:!0,onEntered:Z,onExiting:P,onExited:q},c.createElement("div",d({ref:E,id:e.id,className:R,style:e.style},M,{role:"complementary"}),c.createElement("div",{className:"p-sidebar-header"},L,_),c.createElement("div",{className:"p-sidebar-content"},e.children)))),c.createElement(l.Portal,{element:z,appendTo:e.appendTo,visible:!0}))}));h.displayName="Sidebar",h.defaultProps={__TYPE:"Sidebar",id:null,style:null,className:null,maskStyle:null,maskClassName:null,visible:!1,position:"left",fullScreen:!1,blockScroll:!1,baseZIndex:0,dismissable:!0,showCloseIcon:!0,ariaCloseLabel:null,closeOnEscape:!0,icons:null,modal:!0,appendTo:null,transitionOptions:null,onShow:null,onHide:null},exports.Sidebar=h;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react"),t=require("primereact/api"),n=require("primereact/csstransition"),r=require("primereact/hooks"),l=require("primereact/portal"),i=require("primereact/ripple"),o=require("primereact/utils");function a(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}function s(e){if(e&&e.__esModule)return e;var t=Object.create(null);return e&&Object.keys(e).forEach((function(n){if("default"!==n){var r=Object.getOwnPropertyDescriptor(e,n);Object.defineProperty(t,n,r.get?r:{enumerable:!0,get:function(){return e[n]}})}})),t.default=e,Object.freeze(t)}var c=s(e),u=a(t);function d(){return d=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e},d.apply(this,arguments)}function f(e){if(Array.isArray(e))return e}function p(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var r,l,i,o,a=[],s=!0,c=!1;try{if(i=(n=n.call(e)).next,0===t){if(Object(n)!==n)return;s=!1}else for(;!(s=(r=i.call(n)).done)&&(a.push(r.value),a.length!==t);s=!0);}catch(e){c=!0,l=e}finally{try{if(!s&&null!=n.return&&(o=n.return(),Object(o)!==o))return}finally{if(c)throw l}}return a}}function m(e,t){(null==t||t>e.length)&&(t=e.length);for(var n=0,r=new Array(t);n<t;n++)r[n]=e[n];return r}function b(e,t){if(e){if("string"==typeof e)return m(e,t);var n=Object.prototype.toString.call(e).slice(8,-1);return"Object"===n&&e.constructor&&(n=e.constructor.name),"Map"===n||"Set"===n?Array.from(e):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?m(e,t):void 0}}function v(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}function y(e,t){return f(e)||p(e,t)||b(e,t)||v()}var h=c.forwardRef((function(e,a){var s=y(c.useState(!1),2),f=s[0],p=s[1],m=y(c.useState(!1),2),b=m[0],v=m[1],E=c.useRef(null),S=c.useRef(null),O=c.useRef(null),g=y(r.useEventListener({type:"keydown",listener:function(e){27===e.which&&o.ZIndexUtils.get(S.current)===o.ZIndexUtils.getCurrent("modal",u.default.autoZIndex)&&U(e)}}),2),w=g[0],k=g[1],I=y(r.useEventListener({type:"click",listener:function(e){2!==e.which&&C(e)&&U(e)}}),2),j=I[0],x=I[1],C=function(e){return E&&E.current&&!E.current.contains(e.target)},N=function(t){e.dismissable&&e.modal&&S.current===t.target&&U(t)},U=function(t){e.onHide(),t.preventDefault()},Z=function(){var t;e.onShow&&e.onShow(),!((t=document.activeElement)&&E&&E.current.contains(t))&&e.showCloseIcon&&O.current.focus(),D()},P=function(){e.modal&&o.DomHandler.addClass(S.current,"p-component-overlay-leave")},q=function(){o.ZIndexUtils.clear(S.current),p(!1),A()},D=function(){e.closeOnEscape&&w(),e.dismissable&&!e.modal&&j(),e.blockScroll&&o.DomHandler.addClass(document.body,"p-overflow-hidden")},A=function(){k(),x(),e.blockScroll&&o.DomHandler.removeClass(document.body,"p-overflow-hidden")};c.useImperativeHandle(a,(function(){return{props:e,getElement:function(){return E.current},gteMask:function(){return S.current},getCloseIcon:function(){return O.current}}})),r.useMountEffect((function(){e.visible&&p(!0)})),r.useUpdateEffect((function(){e.visible&&!f&&p(!0),e.visible!==b&&f&&v(e.visible)})),r.useUpdateEffect((function(){f&&(o.ZIndexUtils.set("modal",S.current,u.default.autoZIndex,e.baseZIndex||u.default.zIndex.modal),v(!0))}),[f]),r.useUpdateEffect((function(){b&&(x(),e.dismissable&&!e.modal&&j())}),[e.dismissable,e.modal,b]),r.useUnmountEffect((function(){A(),S.current&&o.ZIndexUtils.clear(S.current)}));var H,M,R,T,_,L,z,J=function(){if(e.showCloseIcon){var n=e.ariaCloseLabel||t.localeOption("close");return c.createElement("button",{type:"button",ref:O,className:"p-sidebar-close p-sidebar-icon p-link",onClick:U,"aria-label":n},c.createElement("span",{className:"p-sidebar-close-icon pi pi-times","aria-hidden":"true"}),c.createElement(i.Ripple,null))}return null};return f&&(M=o.ObjectUtils.findDiffKeys(e,h.defaultProps),R=o.classNames("p-sidebar p-component",e.className,{"p-input-filled":"filled"===u.default.inputStyle,"p-ripple-disabled":!1===u.default.ripple}),T=o.classNames("p-sidebar-mask",{"p-component-overlay p-component-overlay-enter":e.modal,"p-sidebar-mask-scrollblocker":e.blockScroll,"p-sidebar-visible":f,"p-sidebar-full":e.fullScreen},(H=["left","right","top","bottom"].find((function(t){return t===e.position})))?"p-sidebar-".concat(H):"",e.maskClassName),_=J(),L=e.icons?o.ObjectUtils.getJSXElement(e.icons,e):null,z=c.createElement("div",{ref:S,style:e.maskStyle,className:T,onMouseDown:N},c.createElement(n.CSSTransition,{nodeRef:E,classNames:"p-sidebar",in:b,timeout:{enter:e.fullScreen?150:300,exit:e.fullScreen?150:300},options:e.transitionOptions,unmountOnExit:!0,onEntered:Z,onExiting:P,onExited:q},c.createElement("div",d({ref:E,id:e.id,className:R,style:e.style},M,{role:"complementary"}),c.createElement("div",{className:"p-sidebar-header"},L,_),c.createElement("div",{className:"p-sidebar-content"},e.children)))),c.createElement(l.Portal,{element:z,appendTo:e.appendTo,visible:!0}))}));h.displayName="Sidebar",h.defaultProps={__TYPE:"Sidebar",id:null,style:null,className:null,maskStyle:null,maskClassName:null,visible:!1,position:"left",fullScreen:!1,blockScroll:!1,baseZIndex:0,dismissable:!0,showCloseIcon:!0,ariaCloseLabel:null,closeOnEscape:!0,icons:null,modal:!0,appendTo:null,transitionOptions:null,onShow:null,onHide:null},exports.Sidebar=h;