primereact 8.7.3 → 9.0.0-rc.1

package/skeleton/skeleton.d.ts

@@ -1,19 +1,69 @@
+/**
+ *
+ * Skeleton is a placeholder to display instead of the actual content.
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/skeleton/)
+ *
+ * @module skeleton
+ *
+ */
 import * as React from 'react';
 
-type SkeletonShapeType = 'rectangle' | 'circle';
-
-type SkeletonAnimationType = 'wave' | 'none';
-
+/**
+ * Defines valid properties in Skeleton component. In addition to these, all properties of HTMLDivElement can be used in this component.
+ * @group Properties
+ */
 export interface SkeletonProps extends Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, 'ref'> {
-    shape?: SkeletonShapeType;
-    size?: string;
-    width?: string;
-    height?: string;
-    borderRadius?: string;
-    animation?: SkeletonAnimationType;
-    children?: React.ReactNode;
+    /**
+     * It specifies an alternate text for an image, if the image cannot be displayed.
+     * @defaultValue rectangle
+     */
+    shape?: 'rectangle' | 'circle' | undefined;
+    /**
+     * Size of the Circle or Square.
+     */
+    size?: string | undefined;
+    /**
+     * Width of the element.
+     * @defaultValue 100%
+     */
+    width?: string | undefined;
+    /**
+     * Height of the element.
+     * @defaultValue 1rem
+     */
+    height?: string | undefined;
+    /**
+     * Border radius of the element, defaults to value from theme.
+     */
+    borderRadius?: string | undefined;
+    /**
+     * Type of the animation, valid options are "wave" and "none".
+     * @defaultValue wave
+     */
+    animation?: 'wave' | 'none' | undefined;
+    /**
+     * Used to get the child elements of the component.
+     * @readonly
+     */
+    children?: React.ReactNode | undefined;
 }
 
+/**
+ * **PrimeReact - Skeleton**
+ *
+ * _Skeleton is a placeholder to display instead of the actual content._
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/skeleton/)
+ * --- ---
+ * ![PrimeReact](https://primefaces.org/cdn/primereact/images/logo-100.png)
+ *
+ * @group Component
+ */
 export declare class Skeleton extends React.Component<SkeletonProps, any> {
+    /**
+     * Used to get container element.
+     * @return {HTMLDivElement} Container element
+     */
     public getElement(): HTMLDivElement;
 }

package/skeleton/skeleton.esm.js

@@ -16,9 +16,31 @@ function _extends() {
   return _extends.apply(this, arguments);
 }
 
-var Skeleton = /*#__PURE__*/React.memo( /*#__PURE__*/React.forwardRef(function (props, ref) {
+var SkeletonBase = {
+  defaultProps: {
+    __TYPE: 'Skeleton',
+    shape: 'rectangle',
+    size: null,
+    width: '100%',
+    height: '1rem',
+    borderRadius: null,
+    animation: 'wave',
+    style: null,
+    className: null,
+    children: undefined
+  },
+  getProps: function getProps(props) {
+    return ObjectUtils.getMergedProps(props, SkeletonBase.defaultProps);
+  },
+  getOtherProps: function getOtherProps(props) {
+    return ObjectUtils.getDiffProps(props, SkeletonBase.defaultProps);
+  }
+};
+
+var Skeleton = /*#__PURE__*/React.memo( /*#__PURE__*/React.forwardRef(function (inProps, ref) {
+  var props = SkeletonBase.getProps(inProps);
   var elementRef = React.useRef(null);
-  var otherProps = ObjectUtils.findDiffKeys(props, Skeleton.defaultProps);
+  var otherProps = SkeletonBase.getOtherProps(props);
   var style = props.size ? {
     width: props.size,
     height: props.size,
@@ -47,16 +69,5 @@ var Skeleton = /*#__PURE__*/React.memo( /*#__PURE__*/React.forwardRef(function (
   }, otherProps));
 }));
 Skeleton.displayName = 'Skeleton';
-Skeleton.defaultProps = {
-  __TYPE: 'Skeleton',
-  shape: 'rectangle',
-  size: null,
-  width: '100%',
-  height: '1rem',
-  borderRadius: null,
-  animation: 'wave',
-  style: null,
-  className: null
-};
 
 export { Skeleton };

package/skeleton/skeleton.esm.min.js

@@ -1 +1 @@
-import*as e from"react";import{ObjectUtils as r,classNames as t}from"primereact/utils";function n(){return n=Object.assign?Object.assign.bind():function(e){for(var r=1;r<arguments.length;r++){var t=arguments[r];for(var n in t)Object.prototype.hasOwnProperty.call(t,n)&&(e[n]=t[n])}return e},n.apply(this,arguments)}var i=e.memo(e.forwardRef((function(a,s){var o=e.useRef(null),l=r.findDiffKeys(a,i.defaultProps),u=a.size?{width:a.size,height:a.size,borderRadius:a.borderRadius}:{width:a.width,height:a.height,borderRadius:a.borderRadius},c=t("p-skeleton p-component",{"p-skeleton-circle":"circle"===a.shape,"p-skeleton-none":"none"===a.animation},a.className);return e.useImperativeHandle(s,(function(){return{props:a,getElement:function(){return o.current}}})),e.createElement("div",n({ref:o,style:u,className:c},l))})));i.displayName="Skeleton",i.defaultProps={__TYPE:"Skeleton",shape:"rectangle",size:null,width:"100%",height:"1rem",borderRadius:null,animation:"wave",style:null,className:null};export{i as Skeleton};
+import*as e from"react";import{ObjectUtils as r,classNames as t}from"primereact/utils";function n(){return n=Object.assign?Object.assign.bind():function(e){for(var r=1;r<arguments.length;r++){var t=arguments[r];for(var n in t)Object.prototype.hasOwnProperty.call(t,n)&&(e[n]=t[n])}return e},n.apply(this,arguments)}var o={defaultProps:{__TYPE:"Skeleton",shape:"rectangle",size:null,width:"100%",height:"1rem",borderRadius:null,animation:"wave",style:null,className:null,children:void 0},getProps:function(e){return r.getMergedProps(e,o.defaultProps)},getOtherProps:function(e){return r.getDiffProps(e,o.defaultProps)}},i=e.memo(e.forwardRef((function(r,i){var s=o.getProps(r),a=e.useRef(null),l=o.getOtherProps(s),u=s.size?{width:s.size,height:s.size,borderRadius:s.borderRadius}:{width:s.width,height:s.height,borderRadius:s.borderRadius},p=t("p-skeleton p-component",{"p-skeleton-circle":"circle"===s.shape,"p-skeleton-none":"none"===s.animation},s.className);return e.useImperativeHandle(i,(function(){return{props:s,getElement:function(){return a.current}}})),e.createElement("div",n({ref:a,style:u,className:p},l))})));i.displayName="Skeleton";export{i as Skeleton};

package/skeleton/skeleton.js

@@ -37,9 +37,31 @@ this.primereact.skeleton = (function (exports, React, utils) {
     return _extends.apply(this, arguments);
   }
 
-  var Skeleton = /*#__PURE__*/React__namespace.memo( /*#__PURE__*/React__namespace.forwardRef(function (props, ref) {
+  var SkeletonBase = {
+    defaultProps: {
+      __TYPE: 'Skeleton',
+      shape: 'rectangle',
+      size: null,
+      width: '100%',
+      height: '1rem',
+      borderRadius: null,
+      animation: 'wave',
+      style: null,
+      className: null,
+      children: undefined
+    },
+    getProps: function getProps(props) {
+      return utils.ObjectUtils.getMergedProps(props, SkeletonBase.defaultProps);
+    },
+    getOtherProps: function getOtherProps(props) {
+      return utils.ObjectUtils.getDiffProps(props, SkeletonBase.defaultProps);
+    }
+  };
+
+  var Skeleton = /*#__PURE__*/React__namespace.memo( /*#__PURE__*/React__namespace.forwardRef(function (inProps, ref) {
+    var props = SkeletonBase.getProps(inProps);
     var elementRef = React__namespace.useRef(null);
-    var otherProps = utils.ObjectUtils.findDiffKeys(props, Skeleton.defaultProps);
+    var otherProps = SkeletonBase.getOtherProps(props);
     var style = props.size ? {
       width: props.size,
       height: props.size,
@@ -68,17 +90,6 @@ this.primereact.skeleton = (function (exports, React, utils) {
     }, otherProps));
   }));
   Skeleton.displayName = 'Skeleton';
-  Skeleton.defaultProps = {
-    __TYPE: 'Skeleton',
-    shape: 'rectangle',
-    size: null,
-    width: '100%',
-    height: '1rem',
-    borderRadius: null,
-    animation: 'wave',
-    style: null,
-    className: null
-  };
 
   exports.Skeleton = Skeleton;
 

package/skeleton/skeleton.min.js

@@ -1 +1 @@
-this.primereact=this.primereact||{},this.primereact.skeleton=function(e,t,r){"use strict";function n(e){if(e&&e.__esModule)return e;var t=Object.create(null);return e&&Object.keys(e).forEach((function(r){if("default"!==r){var n=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(t,r,n.get?n:{enumerable:!0,get:function(){return e[r]}})}})),t.default=e,Object.freeze(t)}var i=n(t);function a(){return a=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var r=arguments[t];for(var n in r)Object.prototype.hasOwnProperty.call(r,n)&&(e[n]=r[n])}return e},a.apply(this,arguments)}var s=i.memo(i.forwardRef((function(e,t){var n=i.useRef(null),l=r.ObjectUtils.findDiffKeys(e,s.defaultProps),o=e.size?{width:e.size,height:e.size,borderRadius:e.borderRadius}:{width:e.width,height:e.height,borderRadius:e.borderRadius},u=r.classNames("p-skeleton p-component",{"p-skeleton-circle":"circle"===e.shape,"p-skeleton-none":"none"===e.animation},e.className);return i.useImperativeHandle(t,(function(){return{props:e,getElement:function(){return n.current}}})),i.createElement("div",a({ref:n,style:o,className:u},l))})));return s.displayName="Skeleton",s.defaultProps={__TYPE:"Skeleton",shape:"rectangle",size:null,width:"100%",height:"1rem",borderRadius:null,animation:"wave",style:null,className:null},e.Skeleton=s,Object.defineProperty(e,"__esModule",{value:!0}),e}({},React,primereact.utils);
+this.primereact=this.primereact||{},this.primereact.skeleton=function(e,t,r){"use strict";function n(e){if(e&&e.__esModule)return e;var t=Object.create(null);return e&&Object.keys(e).forEach((function(r){if("default"!==r){var n=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(t,r,n.get?n:{enumerable:!0,get:function(){return e[r]}})}})),t.default=e,Object.freeze(t)}var i=n(t);function s(){return s=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var r=arguments[t];for(var n in r)Object.prototype.hasOwnProperty.call(r,n)&&(e[n]=r[n])}return e},s.apply(this,arguments)}var a={defaultProps:{__TYPE:"Skeleton",shape:"rectangle",size:null,width:"100%",height:"1rem",borderRadius:null,animation:"wave",style:null,className:null,children:void 0},getProps:function(e){return r.ObjectUtils.getMergedProps(e,a.defaultProps)},getOtherProps:function(e){return r.ObjectUtils.getDiffProps(e,a.defaultProps)}},o=i.memo(i.forwardRef((function(e,t){var n=a.getProps(e),o=i.useRef(null),l=a.getOtherProps(n),u=n.size?{width:n.size,height:n.size,borderRadius:n.borderRadius}:{width:n.width,height:n.height,borderRadius:n.borderRadius},c=r.classNames("p-skeleton p-component",{"p-skeleton-circle":"circle"===n.shape,"p-skeleton-none":"none"===n.animation},n.className);return i.useImperativeHandle(t,(function(){return{props:n,getElement:function(){return o.current}}})),i.createElement("div",s({ref:o,style:u,className:c},l))})));return o.displayName="Skeleton",e.Skeleton=o,Object.defineProperty(e,"__esModule",{value:!0}),e}({},React,primereact.utils);

package/slidemenu/package.json

@@ -2,5 +2,6 @@
     "main": "./slidemenu.cjs.js",
     "module": "./slidemenu.esm.js",
     "unpkg": "./slidemenu.min.js",
-    "types": "./slidemenu.d.ts"
+    "types": "./slidemenu.d.ts",
+    "sideEffects": false
 }

package/slidemenu/slidemenu.cjs.js

@@ -66,9 +66,7 @@ function _iterableToArrayLimit(arr, i) {
       if (_x = (_i = _i.call(arr)).next, 0 === i) {
         if (Object(_i) !== _i) return;
         _n = !1;
-      } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0) {
-        ;
-      }
+      } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0);
     } catch (err) {
       _d = !0, _e = err;
     } finally {
@@ -84,9 +82,7 @@ function _iterableToArrayLimit(arr, i) {
 
 function _arrayLikeToArray(arr, len) {
   if (len == null || len > arr.length) len = arr.length;
-  for (var i = 0, arr2 = new Array(len); i < len; i++) {
-    arr2[i] = arr[i];
-  }
+  for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i];
   return arr2;
 }
 
@@ -107,6 +103,36 @@ function _slicedToArray(arr, i) {
   return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest();
 }
 
+var SlideMenuBase = {
+  defaultProps: {
+    __TYPE: 'SlideMenu',
+    appendTo: null,
+    autoZIndex: true,
+    backLabel: 'Back',
+    baseZIndex: 0,
+    className: null,
+    easing: 'ease-out',
+    effectDuration: 250,
+    id: null,
+    menuWidth: 190,
+    model: null,
+    onHide: null,
+    onShow: null,
+    onNavigate: null,
+    popup: false,
+    style: null,
+    transitionOptions: null,
+    viewportHeight: 175,
+    children: undefined
+  },
+  getProps: function getProps(props) {
+    return utils.ObjectUtils.getMergedProps(props, SlideMenuBase.defaultProps);
+  },
+  getOtherProps: function getOtherProps(props) {
+    return utils.ObjectUtils.getDiffProps(props, SlideMenuBase.defaultProps);
+  }
+};
+
 function _typeof(obj) {
   "@babel/helpers - typeof";
 
@@ -286,7 +312,8 @@ var SlideMenuSub = /*#__PURE__*/React__namespace.memo(function (props) {
 });
 SlideMenuSub.displayName = 'SlideMenuSub';
 
-var SlideMenu = /*#__PURE__*/React__namespace.memo( /*#__PURE__*/React__namespace.forwardRef(function (props, ref) {
+var SlideMenu = /*#__PURE__*/React__namespace.memo( /*#__PURE__*/React__namespace.forwardRef(function (inProps, ref) {
+  var props = SlideMenuBase.getProps(inProps);
   var _React$useState = React__namespace.useState(0),
     _React$useState2 = _slicedToArray(_React$useState, 2),
     levelState = _React$useState2[0],
@@ -399,7 +426,7 @@ var SlideMenu = /*#__PURE__*/React__namespace.memo( /*#__PURE__*/React__namespac
     }), /*#__PURE__*/React__namespace.createElement("span", null, props.backLabel));
   };
   var createElement = function createElement() {
-    var otherProps = utils.ObjectUtils.findDiffKeys(props, SlideMenu.defaultProps);
+    var otherProps = SlideMenuBase.getOtherProps(props);
     var className = utils.classNames('p-slidemenu p-component', {
       'p-slidemenu-overlay': props.popup
     }, props.className);
@@ -453,25 +480,5 @@ var SlideMenu = /*#__PURE__*/React__namespace.memo( /*#__PURE__*/React__namespac
   }) : element;
 }));
 SlideMenu.displayName = 'SlideMenu';
-SlideMenu.defaultProps = {
-  __TYPE: 'SlideMenu',
-  appendTo: null,
-  autoZIndex: true,
-  backLabel: 'Back',
-  baseZIndex: 0,
-  className: null,
-  easing: 'ease-out',
-  effectDuration: 250,
-  id: null,
-  menuWidth: 190,
-  model: null,
-  onHide: null,
-  onShow: null,
-  onNavigate: null,
-  popup: false,
-  style: null,
-  transitionOptions: null,
-  viewportHeight: 175
-};
 
 exports.SlideMenu = SlideMenu;

package/slidemenu/slidemenu.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"),i=require("primereact/overlayservice"),o=require("primereact/portal"),a=require("primereact/utils");function u(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}function l(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=l(e),s=u(t);function m(){return m=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},m.apply(this,arguments)}function p(e){if(Array.isArray(e))return e}function f(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var r,i,o,a,u=[],l=!0,c=!1;try{if(o=(n=n.call(e)).next,0===t){if(Object(n)!==n)return;l=!1}else for(;!(l=(r=o.call(n)).done)&&(u.push(r.value),u.length!==t);l=!0);}catch(e){c=!0,i=e}finally{try{if(!l&&null!=n.return&&(a=n.return(),Object(a)!==a))return}finally{if(c)throw i}}return u}}function d(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 d(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)?d(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 p(e)||f(e,t)||b(e,t)||v()}function g(e){return g="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},g(e)}function h(e,t){if("object"!==g(e)||null===e)return e;var n=e[Symbol.toPrimitive];if(void 0!==n){var r=n.call(e,t||"default");if("object"!==g(r))return r;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===t?String:Number)(e)}function O(e){var t=h(e,"string");return"symbol"===g(t)?t:String(t)}function w(e,t,n){return(t=O(t))in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function E(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function S(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?E(Object(n),!0).forEach((function(t){w(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):E(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}var j=c.memo((function(e){var t=y(c.useState(null),2),n=t[0],r=t[1],i=y(c.useState({}),2),o=i[0],u=i[1],l=function(t,n,i){if(n.disabled)t.preventDefault();else if(n.url||t.preventDefault(),n.command&&n.command({originalEvent:t,item:n}),n.items){var a=p(n,i);u(S(S({},o),{},w({},a,!0))),r(n),e.onForward()}},s=function(e){return c.createElement("li",{key:"separator_"+e,className:"p-menu-separator"})},m=function(t,r){var i=o[p(t,r)];return t.items&&i?c.createElement(j,{menuProps:e.menuProps,model:t.items,index:e.index+1,menuWidth:e.menuWidth,effectDuration:e.effectDuration,onForward:e.onForward,parentActive:t===n}):null},p=function(e,t){return e.label+"_"+t},f=function(t,r){if(!1===t.visible)return null;var i=p(t,r),o=n===t,u=a.classNames("p-menuitem",{"p-menuitem-active":o,"p-disabled":t.disabled},t.className),s=a.classNames("p-menuitem-icon",t.icon),f="p-submenu-icon pi pi-fw pi-angle-right",d=a.IconUtils.getJSXIcon(t.icon,{className:"p-menuitem-icon"},{props:e.menuProps}),b=t.label&&c.createElement("span",{className:"p-menuitem-text"},t.label),v=t.items&&c.createElement("span",{className:f}),y=m(t,r),g=c.createElement("a",{href:t.url||"#",className:"p-menuitem-link",target:t.target,onClick:function(e){return l(e,t,r)},"aria-disabled":t.disabled},d,b,v);t.template&&(g=a.ObjectUtils.getJSXElement(t.template,t,{onClick:function(e){return l(e,t,r)},className:"p-menuitem-link",labelClassName:"p-menuitem-text",iconClassName:s,submenuIconClassName:f,element:g,props:e,active:o}));return c.createElement("li",{key:i,id:t.id,className:u,style:t.style},g,y)},d=function(e,t){return e.separator?s(t):f(e,t)},b={width:e.menuWidth+"px",left:e.root?-1*e.level*e.menuWidth+"px":e.menuWidth+"px",transitionProperty:e.root?"left":"none",transitionDuration:e.effectDuration+"ms",transitionTimingFunction:e.easing},v=a.classNames({"p-slidemenu-rootlist":e.root,"p-submenu-list":!e.root,"p-active-submenu":e.parentActive}),g=e.model?e.model.map(d):null;return c.createElement("ul",{className:v,style:b},g)}));j.displayName="SlideMenuSub";var N=c.memo(c.forwardRef((function(e,t){var u=y(c.useState(0),2),l=u[0],p=u[1],f=y(c.useState(!1),2),d=f[0],b=f[1],v=c.useRef(null),g=c.useRef(null),h=c.useRef(null),O=c.useRef(null),w=y(r.useOverlayListener({target:g,overlay:v,listener:function(e,t){t.valid&&T(e)},when:d}),2),E=w[0],S=w[1],x=function(t){e.popup&&i.OverlayService.emit("overlay-click",{originalEvent:t,target:g.current})},P=function(){p((function(e){return e+1}))},k=function(){p((function(e){return e-1}))},D=function(t){e.popup&&(d?T(t):I(t))},I=function(t){g.current=t.currentTarget,b(!0),e.onShow&&e.onShow(t)},T=function(t){g.current=t.currentTarget,b(!1),e.onHide&&e.onHide(t)},U=function(){e.autoZIndex&&a.ZIndexUtils.set("menu",v.current,s.default.autoZIndex,e.baseZIndex||s.default.zIndex.menu),a.DomHandler.absolutePosition(v.current,g.current)},A=function(){E()},C=function(){g.current=null,S()},W=function(){a.ZIndexUtils.clear(v.current),p(0)};r.useUpdateEffect((function(){p(0)}),[e.model]),r.useUpdateEffect((function(){e.onNavigate&&e.onNavigate({level:l})}),[l]),r.useUnmountEffect((function(){a.ZIndexUtils.clear(v.current)})),c.useImperativeHandle(t,(function(){return{props:e,toggle:D,show:I,hide:T,navigateForward:P,navigateBack:k,setLevelState:p,getElement:function(){return v.current}}}));var Z=function(){var t=a.classNames("p-slidemenu-backward",{"p-hidden":0===l});return c.createElement("div",{ref:h,className:t,onClick:k},c.createElement("span",{className:"p-slidemenu-backward-icon pi pi-fw pi-chevron-left"}),c.createElement("span",null,e.backLabel))},_=function(){var t=a.ObjectUtils.findDiffKeys(e,N.defaultProps),r=a.classNames("p-slidemenu p-component",{"p-slidemenu-overlay":e.popup},e.className),i={height:e.viewportHeight+"px"},o=Z();return c.createElement(n.CSSTransition,{nodeRef:v,classNames:"p-connected-overlay",in:!e.popup||d,timeout:{enter:120,exit:100},options:e.transitionOptions,unmountOnExit:!0,onEnter:U,onEntered:A,onExit:C,onExited:W},c.createElement("div",m({ref:v,id:e.id,className:r,style:e.style},t,{onClick:x}),c.createElement("div",{className:"p-slidemenu-wrapper",style:i},c.createElement("div",{className:"p-slidemenu-content",ref:O},c.createElement(j,{menuProps:e,model:e.model,root:!0,index:0,menuWidth:e.menuWidth,effectDuration:e.effectDuration,level:l,parentActive:0===l,onForward:P})),o)))}();return e.popup?c.createElement(o.Portal,{element:_,appendTo:e.appendTo}):_})));N.displayName="SlideMenu",N.defaultProps={__TYPE:"SlideMenu",appendTo:null,autoZIndex:!0,backLabel:"Back",baseZIndex:0,className:null,easing:"ease-out",effectDuration:250,id:null,menuWidth:190,model:null,onHide:null,onShow:null,onNavigate:null,popup:!1,style:null,transitionOptions:null,viewportHeight:175},exports.SlideMenu=N;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react"),t=require("primereact/api"),n=require("primereact/csstransition"),r=require("primereact/hooks"),i=require("primereact/overlayservice"),o=require("primereact/portal"),a=require("primereact/utils");function u(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}function l(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=l(e),s=u(t);function p(){return p=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},p.apply(this,arguments)}function m(e){if(Array.isArray(e))return e}function f(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var r,i,o,a,u=[],l=!0,c=!1;try{if(o=(n=n.call(e)).next,0===t){if(Object(n)!==n)return;l=!1}else for(;!(l=(r=o.call(n)).done)&&(u.push(r.value),u.length!==t);l=!0);}catch(e){c=!0,i=e}finally{try{if(!l&&null!=n.return&&(a=n.return(),Object(a)!==a))return}finally{if(c)throw i}}return u}}function d(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 d(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)?d(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 m(e)||f(e,t)||b(e,t)||v()}var g={defaultProps:{__TYPE:"SlideMenu",appendTo:null,autoZIndex:!0,backLabel:"Back",baseZIndex:0,className:null,easing:"ease-out",effectDuration:250,id:null,menuWidth:190,model:null,onHide:null,onShow:null,onNavigate:null,popup:!1,style:null,transitionOptions:null,viewportHeight:175,children:void 0},getProps:function(e){return a.ObjectUtils.getMergedProps(e,g.defaultProps)},getOtherProps:function(e){return a.ObjectUtils.getDiffProps(e,g.defaultProps)}};function h(e){return h="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},h(e)}function O(e,t){if("object"!==h(e)||null===e)return e;var n=e[Symbol.toPrimitive];if(void 0!==n){var r=n.call(e,t||"default");if("object"!==h(r))return r;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===t?String:Number)(e)}function w(e){var t=O(e,"string");return"symbol"===h(t)?t:String(t)}function E(e,t,n){return(t=w(t))in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function S(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function j(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?S(Object(n),!0).forEach((function(t){E(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):S(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}var P=c.memo((function(e){var t=y(c.useState(null),2),n=t[0],r=t[1],i=y(c.useState({}),2),o=i[0],u=i[1],l=function(t,n,i){if(n.disabled)t.preventDefault();else if(n.url||t.preventDefault(),n.command&&n.command({originalEvent:t,item:n}),n.items){var a=m(n,i);u(j(j({},o),{},E({},a,!0))),r(n),e.onForward()}},s=function(e){return c.createElement("li",{key:"separator_"+e,className:"p-menu-separator"})},p=function(t,r){var i=o[m(t,r)];return t.items&&i?c.createElement(P,{menuProps:e.menuProps,model:t.items,index:e.index+1,menuWidth:e.menuWidth,effectDuration:e.effectDuration,onForward:e.onForward,parentActive:t===n}):null},m=function(e,t){return e.label+"_"+t},f=function(t,r){if(!1===t.visible)return null;var i=m(t,r),o=n===t,u=a.classNames("p-menuitem",{"p-menuitem-active":o,"p-disabled":t.disabled},t.className),s=a.classNames("p-menuitem-icon",t.icon),f="p-submenu-icon pi pi-fw pi-angle-right",d=a.IconUtils.getJSXIcon(t.icon,{className:"p-menuitem-icon"},{props:e.menuProps}),b=t.label&&c.createElement("span",{className:"p-menuitem-text"},t.label),v=t.items&&c.createElement("span",{className:f}),y=p(t,r),g=c.createElement("a",{href:t.url||"#",className:"p-menuitem-link",target:t.target,onClick:function(e){return l(e,t,r)},"aria-disabled":t.disabled},d,b,v);t.template&&(g=a.ObjectUtils.getJSXElement(t.template,t,{onClick:function(e){return l(e,t,r)},className:"p-menuitem-link",labelClassName:"p-menuitem-text",iconClassName:s,submenuIconClassName:f,element:g,props:e,active:o}));return c.createElement("li",{key:i,id:t.id,className:u,style:t.style},g,y)},d=function(e,t){return e.separator?s(t):f(e,t)},b={width:e.menuWidth+"px",left:e.root?-1*e.level*e.menuWidth+"px":e.menuWidth+"px",transitionProperty:e.root?"left":"none",transitionDuration:e.effectDuration+"ms",transitionTimingFunction:e.easing},v=a.classNames({"p-slidemenu-rootlist":e.root,"p-submenu-list":!e.root,"p-active-submenu":e.parentActive}),g=e.model?e.model.map(d):null;return c.createElement("ul",{className:v,style:b},g)}));P.displayName="SlideMenuSub";var N=c.memo(c.forwardRef((function(e,t){var u=g.getProps(e),l=y(c.useState(0),2),m=l[0],f=l[1],d=y(c.useState(!1),2),b=d[0],v=d[1],h=c.useRef(null),O=c.useRef(null),w=c.useRef(null),E=c.useRef(null),S=y(r.useOverlayListener({target:O,overlay:h,listener:function(e,t){t.valid&&T(e)},when:b}),2),j=S[0],N=S[1],x=function(e){u.popup&&i.OverlayService.emit("overlay-click",{originalEvent:e,target:O.current})},k=function(){f((function(e){return e+1}))},D=function(){f((function(e){return e-1}))},I=function(e){u.popup&&(b?T(e):U(e))},U=function(e){O.current=e.currentTarget,v(!0),u.onShow&&u.onShow(e)},T=function(e){O.current=e.currentTarget,v(!1),u.onHide&&u.onHide(e)},A=function(){u.autoZIndex&&a.ZIndexUtils.set("menu",h.current,s.default.autoZIndex,u.baseZIndex||s.default.zIndex.menu),a.DomHandler.absolutePosition(h.current,O.current)},C=function(){j()},M=function(){O.current=null,N()},W=function(){a.ZIndexUtils.clear(h.current),f(0)};r.useUpdateEffect((function(){f(0)}),[u.model]),r.useUpdateEffect((function(){u.onNavigate&&u.onNavigate({level:m})}),[m]),r.useUnmountEffect((function(){a.ZIndexUtils.clear(h.current)})),c.useImperativeHandle(t,(function(){return{props:u,toggle:I,show:U,hide:T,navigateForward:k,navigateBack:D,setLevelState:f,getElement:function(){return h.current}}}));var Z=function(){var e=a.classNames("p-slidemenu-backward",{"p-hidden":0===m});return c.createElement("div",{ref:w,className:e,onClick:D},c.createElement("span",{className:"p-slidemenu-backward-icon pi pi-fw pi-chevron-left"}),c.createElement("span",null,u.backLabel))},_=function(){var e=g.getOtherProps(u),t=a.classNames("p-slidemenu p-component",{"p-slidemenu-overlay":u.popup},u.className),r={height:u.viewportHeight+"px"},i=Z();return c.createElement(n.CSSTransition,{nodeRef:h,classNames:"p-connected-overlay",in:!u.popup||b,timeout:{enter:120,exit:100},options:u.transitionOptions,unmountOnExit:!0,onEnter:A,onEntered:C,onExit:M,onExited:W},c.createElement("div",p({ref:h,id:u.id,className:t,style:u.style},e,{onClick:x}),c.createElement("div",{className:"p-slidemenu-wrapper",style:r},c.createElement("div",{className:"p-slidemenu-content",ref:E},c.createElement(P,{menuProps:u,model:u.model,root:!0,index:0,menuWidth:u.menuWidth,effectDuration:u.effectDuration,level:m,parentActive:0===m,onForward:k})),i)))}();return u.popup?c.createElement(o.Portal,{element:_,appendTo:u.appendTo}):_})));N.displayName="SlideMenu",exports.SlideMenu=N;

package/slidemenu/slidemenu.d.ts

@@ -1,37 +1,151 @@
+/**
+ *
+ * SlideMenu displays submenus with a slide animation.
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/slidemenu/)
+ *
+ * @module slidemenu
+ *
+ */
 import * as React from 'react';
 import { CSSTransitionProps } from '../csstransition';
 import { MenuItem } from '../menuitem';
 
-type SlideMenuAppendToType = 'self' | HTMLElement | undefined | null;
-
-interface SlideMenuNavigateParams {
+/**
+ * Custom navigate event
+ * @see {@link SlideMenuProps.onNavigate}
+ * @event
+ */
+interface SlideMenuNavigateEvent {
+    /**
+     * Level of current displayed menu
+     */
     level: number;
 }
 
+/**
+ * Defines valid properties in SlideMenu component. In addition to these, all properties of HTMLDivElement can be used in this component.
+ * @group Properties
+ */
 export interface SlideMenuProps extends Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, 'ref'> {
-    appendTo?: SlideMenuAppendToType;
-    autoZIndex?: boolean;
-    backLabel?: string;
-    baseZIndex?: number;
-    children?: React.ReactNode;
-    easing?: string;
-    effectDuration?: number;
-    menuWidth?: number;
-    model?: MenuItem[];
-    popup?: boolean;
-    transitionOptions?: CSSTransitionProps;
-    viewportHeight?: number;
-    onShow?(e: React.SyntheticEvent): void;
-    onHide?(e: React.SyntheticEvent): void;
-    onNavigate?(e: SlideMenuNavigateParams): void;
+    /**
+     * DOM element instance where the overlay panel should be mounted. Valid values are any DOM Element and 'self'. The self value is used to render a component where it is located.
+     * @defaultValue document.body
+     */
+    appendTo?: 'self' | HTMLElement | undefined | null;
+    /**
+     * Whether to automatically manage layering.
+     * @defaultValue true
+     */
+    autoZIndex?: boolean | undefined;
+    /**
+     * Label of element to navigate back.
+     * @defaultValue Back
+     */
+    backLabel?: string | undefined;
+    /**
+     * Base zIndex value to use in layering.
+     * @defaultValue 0
+     */
+    baseZIndex?: number | undefined;
+    /**
+     * Used to get the child elements of the component.
+     * @readonly
+     */
+    children?: React.ReactNode | undefined;
+    /**
+     * Easing animation to use for sliding.
+     * @defaultValue ease-out
+     */
+    easing?: string | undefined;
+    /**
+     * Duration of the sliding animation in milliseconds.
+     * @defaultValue 250
+     */
+    effectDuration?: number | undefined;
+    /**
+     * Width of the submenus.
+     * @defaultValue 190
+     */
+    menuWidth?: number | undefined;
+    /**
+     * An array of menuitems.
+     */
+    model?: MenuItem[] | undefined;
+    /**
+     * Defines if menu would displayed as a popup.
+     * @defaultValue false
+     */
+    popup?: boolean | undefined;
+    /**
+     * The properties of CSSTransition can be customized, except for "nodeRef" and "in" properties.
+     */
+    transitionOptions?: CSSTransitionProps | undefined;
+    /**
+     * Height of the scrollable area, a scrollbar appears if a menu height is longer than this value.
+     * @defaultValue 175
+     */
+    viewportHeight?: number | undefined;
+    /**
+     * Callback to invoke when a popup menu is shown.
+     * @param {React.SyntheticEvent} event - Browser event.
+     */
+    onShow?(event: React.SyntheticEvent): void;
+    /**
+     * Callback to invoke when a popup menu is hidden.
+     * @param {React.SyntheticEvent} event - Browser event.
+     */
+    onHide?(event: React.SyntheticEvent): void;
+    /**
+     * Callback to invoke when a menu is navigated to.
+     * @param {SlideMenuNavigateEvent} event - Navigate event.
+     */
+    onNavigate?(event: SlideMenuNavigateEvent): void;
 }
 
+/**
+ * **PrimeReact - SlideMenu**
+ *
+ * _SlideMenu displays submenus with a slide animation._
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/slidemenu/)
+ * --- ---
+ * ![PrimeReact](https://primefaces.org/cdn/primereact/images/logo-100.png)
+ *
+ * @group Component
+ */
 export declare class SlideMenu extends React.Component<SlideMenuProps, any> {
+    /**
+     * Displays the popup menu.
+     * @param {React.SyntheticEvent} event - Browser event
+     */
     public show(event: React.SyntheticEvent): void;
+    /**
+     * Hides the popup menu.
+     * @param {React.SyntheticEvent} event - Browser event
+     */
     public hide(event: React.SyntheticEvent): void;
+    /**
+     * Toggles the visibility of the popup menu.
+     * @param {React.SyntheticEvent} event - Browser event
+     */
     public toggle(event: React.SyntheticEvent): void;
+    /**
+     * Navigates the slide menu to this specific level.
+     * @param {number} level - Number of the menu to set
+     */
     public setLevelState(level: number): void;
+    /**
+     * Navigates the slide menu forward.
+     */
     public navigateForward(): void;
+    /**
+     * Navigates the slide menu backwards.
+     */
     public navigateBack(): void;
+    /**
+     * Used to get container element.
+     * @return {HTMLDivElement} Container element
+     */
     public getElement(): HTMLDivElement;
 }

package/slidemenu/slidemenu.esm.js

@@ -4,7 +4,7 @@ import { CSSTransition } from 'primereact/csstransition';
 import { useOverlayListener, useUpdateEffect, useUnmountEffect } from 'primereact/hooks';
 import { OverlayService } from 'primereact/overlayservice';
 import { Portal } from 'primereact/portal';
-import { classNames, IconUtils, ObjectUtils, ZIndexUtils, DomHandler } from 'primereact/utils';
+import { ObjectUtils, classNames, IconUtils, ZIndexUtils, DomHandler } from 'primereact/utils';
 
 function _extends() {
   _extends = Object.assign ? Object.assign.bind() : function (target) {
@@ -39,9 +39,7 @@ function _iterableToArrayLimit(arr, i) {
       if (_x = (_i = _i.call(arr)).next, 0 === i) {
         if (Object(_i) !== _i) return;
         _n = !1;
-      } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0) {
-        ;
-      }
+      } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0);
     } catch (err) {
       _d = !0, _e = err;
     } finally {
@@ -57,9 +55,7 @@ function _iterableToArrayLimit(arr, i) {
 
 function _arrayLikeToArray(arr, len) {
   if (len == null || len > arr.length) len = arr.length;
-  for (var i = 0, arr2 = new Array(len); i < len; i++) {
-    arr2[i] = arr[i];
-  }
+  for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i];
   return arr2;
 }
 
@@ -80,6 +76,36 @@ function _slicedToArray(arr, i) {
   return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest();
 }
 
+var SlideMenuBase = {
+  defaultProps: {
+    __TYPE: 'SlideMenu',
+    appendTo: null,
+    autoZIndex: true,
+    backLabel: 'Back',
+    baseZIndex: 0,
+    className: null,
+    easing: 'ease-out',
+    effectDuration: 250,
+    id: null,
+    menuWidth: 190,
+    model: null,
+    onHide: null,
+    onShow: null,
+    onNavigate: null,
+    popup: false,
+    style: null,
+    transitionOptions: null,
+    viewportHeight: 175,
+    children: undefined
+  },
+  getProps: function getProps(props) {
+    return ObjectUtils.getMergedProps(props, SlideMenuBase.defaultProps);
+  },
+  getOtherProps: function getOtherProps(props) {
+    return ObjectUtils.getDiffProps(props, SlideMenuBase.defaultProps);
+  }
+};
+
 function _typeof(obj) {
   "@babel/helpers - typeof";
 
@@ -259,7 +285,8 @@ var SlideMenuSub = /*#__PURE__*/React.memo(function (props) {
 });
 SlideMenuSub.displayName = 'SlideMenuSub';
 
-var SlideMenu = /*#__PURE__*/React.memo( /*#__PURE__*/React.forwardRef(function (props, ref) {
+var SlideMenu = /*#__PURE__*/React.memo( /*#__PURE__*/React.forwardRef(function (inProps, ref) {
+  var props = SlideMenuBase.getProps(inProps);
   var _React$useState = React.useState(0),
     _React$useState2 = _slicedToArray(_React$useState, 2),
     levelState = _React$useState2[0],
@@ -372,7 +399,7 @@ var SlideMenu = /*#__PURE__*/React.memo( /*#__PURE__*/React.forwardRef(function
     }), /*#__PURE__*/React.createElement("span", null, props.backLabel));
   };
   var createElement = function createElement() {
-    var otherProps = ObjectUtils.findDiffKeys(props, SlideMenu.defaultProps);
+    var otherProps = SlideMenuBase.getOtherProps(props);
     var className = classNames('p-slidemenu p-component', {
       'p-slidemenu-overlay': props.popup
     }, props.className);
@@ -426,25 +453,5 @@ var SlideMenu = /*#__PURE__*/React.memo( /*#__PURE__*/React.forwardRef(function
   }) : element;
 }));
 SlideMenu.displayName = 'SlideMenu';
-SlideMenu.defaultProps = {
-  __TYPE: 'SlideMenu',
-  appendTo: null,
-  autoZIndex: true,
-  backLabel: 'Back',
-  baseZIndex: 0,
-  className: null,
-  easing: 'ease-out',
-  effectDuration: 250,
-  id: null,
-  menuWidth: 190,
-  model: null,
-  onHide: null,
-  onShow: null,
-  onNavigate: null,
-  popup: false,
-  style: null,
-  transitionOptions: null,
-  viewportHeight: 175
-};
 
 export { SlideMenu };