primereact 8.7.2 → 9.0.0-beta.1

package/chart/chart.cjs.min.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react"),t=require("primereact/hooks"),r=require("primereact/utils");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 u=n(e);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 c=function(){try{return Chart}catch(e){return null}}(),i=u.memo(u.forwardRef((function(e,l){var s=u.useRef(null),o=u.useRef(null),f=u.useRef(null),p=function(){d();var t={type:e.type,data:e.data,options:e.options,plugins:e.plugins};c?o.current=new c(f.current,t):Promise.resolve().then((function(){return n(require("chart.js/auto"))})).then((function(e){d(),e&&(o.current=e.default?new e.default(f.current,t):new e(f.current,t))}))},d=function(){o.current&&(o.current.destroy(),o.current=null)};u.useImperativeHandle(l,(function(){return{props:e,getCanvas:function(){return f.current},getChart:function(){return o.current},getBase64Image:function(){return o.current.toBase64Image()},getElement:function(){return s.current},generateLegend:function(){return o.current&&o.current.generateLegend()},refresh:function(){return o.current&&o.current.update()}}})),u.useEffect((function(){p()})),t.useUnmountEffect((function(){d()}));var h=r.ObjectUtils.findDiffKeys(e,i.defaultProps),g=r.classNames("p-chart",e.className),y=Object.assign({width:e.width,height:e.height},e.style);return u.createElement("div",a({id:e.id,ref:s,style:y,className:g},h),u.createElement("canvas",{ref:f,width:e.width,height:e.height}))})),(function(e,t){return e.data===t.data&&e.options===t.options&&e.type===t.type}));i.displayName="Chart",i.defaultProps={__TYPE:"Chart",id:null,type:null,data:null,options:null,plugins:null,width:null,height:null,style:null,className:null},exports.Chart=i;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react"),t=require("primereact/hooks"),r=require("primereact/utils");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 u=n(e);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 c=function(){try{return Chart}catch(e){return null}}(),i=u.memo(u.forwardRef((function(e,l){var s=u.useRef(null),o=u.useRef(null),f=u.useRef(null),p=function(){d();var t={type:e.type,data:e.data,options:e.options,plugins:e.plugins};c?o.current=new c(f.current,t):Promise.resolve().then((function(){return n(require("chart.js/auto"))})).then((function(e){d(),f.current&&e&&(o.current=e.default?new e.default(f.current,t):new e(f.current,t))}))},d=function(){o.current&&(o.current.destroy(),o.current=null)};u.useImperativeHandle(l,(function(){return{props:e,getCanvas:function(){return f.current},getChart:function(){return o.current},getBase64Image:function(){return o.current.toBase64Image()},getElement:function(){return s.current},generateLegend:function(){return o.current&&o.current.generateLegend()},refresh:function(){return o.current&&o.current.update()}}})),u.useEffect((function(){p()})),t.useUnmountEffect((function(){d()}));var h=r.ObjectUtils.findDiffKeys(e,i.defaultProps),g=r.classNames("p-chart",e.className),y=Object.assign({width:e.width,height:e.height},e.style);return u.createElement("div",a({id:e.id,ref:s,style:y,className:g},h),u.createElement("canvas",{ref:f,width:e.width,height:e.height}))})),(function(e,t){return e.data===t.data&&e.options===t.options&&e.type===t.type}));i.displayName="Chart",i.defaultProps={__TYPE:"Chart",id:null,type:null,data:null,options:null,plugins:null,width:null,height:null,style:null,className:null},exports.Chart=i;

package/chart/chart.d.ts

@@ -1,23 +1,101 @@
+/**
+ *
+ * Chart components are based on Chart.js, an open source HTML5 based charting library.
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/chart)
+ *
+ * @module chart
+ *
+ */
 import * as React from 'react';
 
+/**
+ * Defines valid properties in Chart component.
+ * @group Properties
+ */
 export interface ChartProps {
-    id?: string;
-    type?: string;
-    data?: object;
-    options?: object;
-    plugins?: any[];
-    width?: string;
-    height?: string;
-    style?: React.CSSProperties;
-    className?: string;
-    children?: React.ReactNode;
+    /**
+     * Unique identifier of the element.
+     */
+    id?: string | undefined;
+    /**
+     * Type of the chart.
+     */
+    type?: string | undefined;
+    /**
+     * Data to display.
+     */
+    data?: object | undefined;
+    /**
+     * Options to customize the chart.
+     */
+    options?: object | undefined;
+    /**
+     * Used to custom plugins of the chart.
+     */
+    plugins?: any[] | undefined;
+    /**
+     * Width of the chart in non-responsive mode.
+     */
+    width?: string | undefined;
+    /**
+     * Height of the chart in non-responsive mode.
+     */
+    height?: string | undefined;
+    /**
+     * Inline style of the element.
+     */
+    style?: React.CSSProperties | undefined;
+    /**
+     * Style class of the element.
+     */
+    className?: string | undefined;
+    /**
+     * Used to get the child elements of the component.
+     * @readonly
+     */
+    children?: React.ReactNode | undefined;
 }
 
+/**
+ * **PrimeReact - Chart**
+ *
+ * _Chart components are based on Chart.js, an open source HTML5 based charting library._
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/chart/)
+ * --- ---
+ * ![PrimeReact](https://www.primefaces.org/primereact/images/logo-100.png)
+ *
+ * @group Component
+ */
 export declare class Chart extends React.Component<ChartProps, any> {
+    /**
+     * Used to get canvas element.
+     * @return {HTMLCanvasElement} Canvas element
+     */
     public getCanvas(): HTMLCanvasElement;
+    /**
+     * Used to get chart instance.
+     * @return {*} Chart instance
+     */
     public getChart(): any;
+    /**
+     * Used to get base64 image.
+     * @return {*} base64 image
+     */
     public getBase64Image(): any;
+    /**
+     * Used to generate legend.
+     * @return {string} Generated legend
+     */
     public generateLegend(): string;
+    /**
+     * Redraws the graph.
+     */
     public refresh(): void;
+    /**
+     * Used to get container element.
+     * @return {HTMLDivElement} Container element
+     */
     public getElement(): HTMLDivElement;
 }

package/chart/chart.esm.js

@@ -6,19 +6,18 @@ function _extends() {
   _extends = Object.assign ? Object.assign.bind() : function (target) {
     for (var i = 1; i < arguments.length; i++) {
       var source = arguments[i];
-
       for (var key in source) {
         if (Object.prototype.hasOwnProperty.call(source, key)) {
           target[key] = source[key];
         }
       }
     }
-
     return target;
   };
   return _extends.apply(this, arguments);
 }
 
+// GitHub #3059 wrapper if loaded by script tag
 var ChartJS = function () {
   try {
     return Chart;
@@ -26,12 +25,10 @@ var ChartJS = function () {
     return null;
   }
 }();
-
 var PrimeReactChart = /*#__PURE__*/React.memo( /*#__PURE__*/React.forwardRef(function (props, ref) {
   var elementRef = React.useRef(null);
   var chartRef = React.useRef(null);
   var canvasRef = React.useRef(null);
-
   var initChart = function initChart() {
     destroyChart();
     var configuration = {
@@ -40,7 +37,6 @@ var PrimeReactChart = /*#__PURE__*/React.memo( /*#__PURE__*/React.forwardRef(fun
       options: props.options,
       plugins: props.plugins
     };
-
     if (ChartJS) {
       // GitHub #3059 loaded by script only
       chartRef.current = new ChartJS(canvasRef.current, configuration);
@@ -48,6 +44,11 @@ var PrimeReactChart = /*#__PURE__*/React.memo( /*#__PURE__*/React.forwardRef(fun
       import('chart.js/auto').then(function (module) {
         destroyChart();
 
+        // In case that the Chart component has been unmounted during asynchronous loading of ChartJS,
+        // the canvasRef will not be available anymore, and no Chart should be created.
+        if (!canvasRef.current) {
+          return;
+        }
         if (module) {
           if (module["default"]) {
             // WebPack
@@ -60,14 +61,12 @@ var PrimeReactChart = /*#__PURE__*/React.memo( /*#__PURE__*/React.forwardRef(fun
       });
     }
   };
-
   var destroyChart = function destroyChart() {
     if (chartRef.current) {
       chartRef.current.destroy();
       chartRef.current = null;
     }
   };
-
   React.useImperativeHandle(ref, function () {
     return {
       props: props,

package/chart/chart.esm.min.js

@@ -1 +1 @@
-import*as t from"react";import{useUnmountEffect as e}from"primereact/hooks";import{ObjectUtils as n,classNames as r}from"primereact/utils";function u(){return u=Object.assign?Object.assign.bind():function(t){for(var e=1;e<arguments.length;e++){var n=arguments[e];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(t[r]=n[r])}return t},u.apply(this,arguments)}var a=function(){try{return Chart}catch(t){return null}}(),i=t.memo(t.forwardRef((function(c,l){var o=t.useRef(null),s=t.useRef(null),f=t.useRef(null),p=function(){h();var t={type:c.type,data:c.data,options:c.options,plugins:c.plugins};a?s.current=new a(f.current,t):import("chart.js/auto").then((function(e){h(),e&&(s.current=e.default?new e.default(f.current,t):new e(f.current,t))}))},h=function(){s.current&&(s.current.destroy(),s.current=null)};t.useImperativeHandle(l,(function(){return{props:c,getCanvas:function(){return f.current},getChart:function(){return s.current},getBase64Image:function(){return s.current.toBase64Image()},getElement:function(){return o.current},generateLegend:function(){return s.current&&s.current.generateLegend()},refresh:function(){return s.current&&s.current.update()}}})),t.useEffect((function(){p()})),e((function(){h()}));var d=n.findDiffKeys(c,i.defaultProps),g=r("p-chart",c.className),m=Object.assign({width:c.width,height:c.height},c.style);return t.createElement("div",u({id:c.id,ref:o,style:m,className:g},d),t.createElement("canvas",{ref:f,width:c.width,height:c.height}))})),(function(t,e){return t.data===e.data&&t.options===e.options&&t.type===e.type}));i.displayName="Chart",i.defaultProps={__TYPE:"Chart",id:null,type:null,data:null,options:null,plugins:null,width:null,height:null,style:null,className:null};export{i as Chart};
+import*as t from"react";import{useUnmountEffect as e}from"primereact/hooks";import{ObjectUtils as n,classNames as r}from"primereact/utils";function u(){return u=Object.assign?Object.assign.bind():function(t){for(var e=1;e<arguments.length;e++){var n=arguments[e];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(t[r]=n[r])}return t},u.apply(this,arguments)}var a=function(){try{return Chart}catch(t){return null}}(),i=t.memo(t.forwardRef((function(c,l){var o=t.useRef(null),s=t.useRef(null),f=t.useRef(null),p=function(){h();var t={type:c.type,data:c.data,options:c.options,plugins:c.plugins};a?s.current=new a(f.current,t):import("chart.js/auto").then((function(e){h(),f.current&&e&&(s.current=e.default?new e.default(f.current,t):new e(f.current,t))}))},h=function(){s.current&&(s.current.destroy(),s.current=null)};t.useImperativeHandle(l,(function(){return{props:c,getCanvas:function(){return f.current},getChart:function(){return s.current},getBase64Image:function(){return s.current.toBase64Image()},getElement:function(){return o.current},generateLegend:function(){return s.current&&s.current.generateLegend()},refresh:function(){return s.current&&s.current.update()}}})),t.useEffect((function(){p()})),e((function(){h()}));var d=n.findDiffKeys(c,i.defaultProps),g=r("p-chart",c.className),m=Object.assign({width:c.width,height:c.height},c.style);return t.createElement("div",u({id:c.id,ref:o,style:m,className:g},d),t.createElement("canvas",{ref:f,width:c.width,height:c.height}))})),(function(t,e){return t.data===e.data&&t.options===e.options&&t.type===e.type}));i.displayName="Chart",i.defaultProps={__TYPE:"Chart",id:null,type:null,data:null,options:null,plugins:null,width:null,height:null,style:null,className:null};export{i as Chart};

package/chart/chart.js

@@ -26,19 +26,18 @@ this.primereact.chart = (function (exports, React, hooks, utils) {
     _extends = Object.assign ? Object.assign.bind() : function (target) {
       for (var i = 1; i < arguments.length; i++) {
         var source = arguments[i];
-
         for (var key in source) {
           if (Object.prototype.hasOwnProperty.call(source, key)) {
             target[key] = source[key];
           }
         }
       }
-
       return target;
     };
     return _extends.apply(this, arguments);
   }
 
+  // GitHub #3059 wrapper if loaded by script tag
   var ChartJS = function () {
     try {
       return Chart;
@@ -46,12 +45,10 @@ this.primereact.chart = (function (exports, React, hooks, utils) {
       return null;
     }
   }();
-
   var PrimeReactChart = /*#__PURE__*/React__namespace.memo( /*#__PURE__*/React__namespace.forwardRef(function (props, ref) {
     var elementRef = React__namespace.useRef(null);
     var chartRef = React__namespace.useRef(null);
     var canvasRef = React__namespace.useRef(null);
-
     var initChart = function initChart() {
       destroyChart();
       var configuration = {
@@ -60,7 +57,6 @@ this.primereact.chart = (function (exports, React, hooks, utils) {
         options: props.options,
         plugins: props.plugins
       };
-
       if (ChartJS) {
         // GitHub #3059 loaded by script only
         chartRef.current = new ChartJS(canvasRef.current, configuration);
@@ -68,6 +64,11 @@ this.primereact.chart = (function (exports, React, hooks, utils) {
         import('chart.js/auto').then(function (module) {
           destroyChart();
 
+          // In case that the Chart component has been unmounted during asynchronous loading of ChartJS,
+          // the canvasRef will not be available anymore, and no Chart should be created.
+          if (!canvasRef.current) {
+            return;
+          }
           if (module) {
             if (module["default"]) {
               // WebPack
@@ -80,14 +81,12 @@ this.primereact.chart = (function (exports, React, hooks, utils) {
         });
       }
     };
-
     var destroyChart = function destroyChart() {
       if (chartRef.current) {
         chartRef.current.destroy();
         chartRef.current = null;
       }
     };
-
     React__namespace.useImperativeHandle(ref, function () {
       return {
         props: props,

package/chart/chart.min.js

@@ -1 +1 @@
-this.primereact=this.primereact||{},this.primereact.chart=function(e,t,r,n){"use strict";function u(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 a=u(t);function c(){return c=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},c.apply(this,arguments)}var i=function(){try{return Chart}catch(e){return null}}(),l=a.memo(a.forwardRef((function(e,t){var u=a.useRef(null),s=a.useRef(null),o=a.useRef(null),f=function(){p();var t={type:e.type,data:e.data,options:e.options,plugins:e.plugins};i?s.current=new i(o.current,t):import("chart.js/auto").then((function(e){p(),e&&(s.current=e.default?new e.default(o.current,t):new e(o.current,t))}))},p=function(){s.current&&(s.current.destroy(),s.current=null)};a.useImperativeHandle(t,(function(){return{props:e,getCanvas:function(){return o.current},getChart:function(){return s.current},getBase64Image:function(){return s.current.toBase64Image()},getElement:function(){return u.current},generateLegend:function(){return s.current&&s.current.generateLegend()},refresh:function(){return s.current&&s.current.update()}}})),a.useEffect((function(){f()})),r.useUnmountEffect((function(){p()}));var h=n.ObjectUtils.findDiffKeys(e,l.defaultProps),d=n.classNames("p-chart",e.className),g=Object.assign({width:e.width,height:e.height},e.style);return a.createElement("div",c({id:e.id,ref:u,style:g,className:d},h),a.createElement("canvas",{ref:o,width:e.width,height:e.height}))})),(function(e,t){return e.data===t.data&&e.options===t.options&&e.type===t.type}));return l.displayName="Chart",l.defaultProps={__TYPE:"Chart",id:null,type:null,data:null,options:null,plugins:null,width:null,height:null,style:null,className:null},e.Chart=l,Object.defineProperty(e,"__esModule",{value:!0}),e}({},React,primereact.hooks,primereact.utils);
+this.primereact=this.primereact||{},this.primereact.chart=function(e,t,r,n){"use strict";function u(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 a=u(t);function c(){return c=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},c.apply(this,arguments)}var i=function(){try{return Chart}catch(e){return null}}(),l=a.memo(a.forwardRef((function(e,t){var u=a.useRef(null),s=a.useRef(null),o=a.useRef(null),f=function(){p();var t={type:e.type,data:e.data,options:e.options,plugins:e.plugins};i?s.current=new i(o.current,t):import("chart.js/auto").then((function(e){p(),o.current&&e&&(s.current=e.default?new e.default(o.current,t):new e(o.current,t))}))},p=function(){s.current&&(s.current.destroy(),s.current=null)};a.useImperativeHandle(t,(function(){return{props:e,getCanvas:function(){return o.current},getChart:function(){return s.current},getBase64Image:function(){return s.current.toBase64Image()},getElement:function(){return u.current},generateLegend:function(){return s.current&&s.current.generateLegend()},refresh:function(){return s.current&&s.current.update()}}})),a.useEffect((function(){f()})),r.useUnmountEffect((function(){p()}));var h=n.ObjectUtils.findDiffKeys(e,l.defaultProps),d=n.classNames("p-chart",e.className),g=Object.assign({width:e.width,height:e.height},e.style);return a.createElement("div",c({id:e.id,ref:u,style:g,className:d},h),a.createElement("canvas",{ref:o,width:e.width,height:e.height}))})),(function(e,t){return e.data===t.data&&e.options===t.options&&e.type===t.type}));return l.displayName="Chart",l.defaultProps={__TYPE:"Chart",id:null,type:null,data:null,options:null,plugins:null,width:null,height:null,style:null,className:null},e.Chart=l,Object.defineProperty(e,"__esModule",{value:!0}),e}({},React,primereact.hooks,primereact.utils);

package/checkbox/checkbox.cjs.js

@@ -31,14 +31,12 @@ function _extends() {
   _extends = Object.assign ? Object.assign.bind() : function (target) {
     for (var i = 1; i < arguments.length; i++) {
       var source = arguments[i];
-
       for (var key in source) {
         if (Object.prototype.hasOwnProperty.call(source, key)) {
           target[key] = source[key];
         }
       }
     }
-
     return target;
   };
   return _extends.apply(this, arguments);
@@ -49,42 +47,40 @@ function _arrayWithHoles(arr) {
 }
 
 function _iterableToArrayLimit(arr, i) {
-  var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
-
-  if (_i == null) return;
-  var _arr = [];
-  var _n = true;
-  var _d = false;
-
-  var _s, _e;
-
-  try {
-    for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) {
-      _arr.push(_s.value);
-
-      if (i && _arr.length === i) break;
-    }
-  } catch (err) {
-    _d = true;
-    _e = err;
-  } finally {
+  var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"];
+  if (null != _i) {
+    var _s,
+      _e,
+      _x,
+      _r,
+      _arr = [],
+      _n = !0,
+      _d = !1;
     try {
-      if (!_n && _i["return"] != null) _i["return"]();
+      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) {
+        ;
+      }
+    } catch (err) {
+      _d = !0, _e = err;
     } finally {
-      if (_d) throw _e;
+      try {
+        if (!_n && null != _i["return"] && (_r = _i["return"](), Object(_r) !== _r)) return;
+      } finally {
+        if (_d) throw _e;
+      }
     }
+    return _arr;
   }
-
-  return _arr;
 }
 
 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];
   }
-
   return arr2;
 }
 
@@ -107,21 +103,17 @@ function _slicedToArray(arr, i) {
 
 var Checkbox = /*#__PURE__*/React__namespace.memo( /*#__PURE__*/React__namespace.forwardRef(function (props, ref) {
   var _React$useState = React__namespace.useState(false),
-      _React$useState2 = _slicedToArray(_React$useState, 2),
-      focusedState = _React$useState2[0],
-      setFocusedState = _React$useState2[1];
-
+    _React$useState2 = _slicedToArray(_React$useState, 2),
+    focusedState = _React$useState2[0],
+    setFocusedState = _React$useState2[1];
   var elementRef = React__namespace.useRef(null);
   var inputRef = React__namespace.useRef(props.inputRef);
-
   var onClick = function onClick(event) {
     if (!props.disabled && !props.readOnly && props.onChange) {
       var _checked = isChecked();
-
       var checkboxClicked = event.target instanceof HTMLDivElement || event.target instanceof HTMLSpanElement;
       var isInputToggled = event.target === inputRef.current;
       var isCheckboxToggled = checkboxClicked && event.target.checked !== _checked;
-
       if (isInputToggled || isCheckboxToggled) {
         var value = _checked ? props.falseValue : props.trueValue;
         props.onChange({
@@ -139,33 +131,31 @@ var Checkbox = /*#__PURE__*/React__namespace.memo( /*#__PURE__*/React__namespace
           }
         });
       }
-
       utils.DomHandler.focus(inputRef.current);
       event.preventDefault();
     }
   };
-
   var onFocus = function onFocus() {
     setFocusedState(true);
   };
-
   var onBlur = function onBlur() {
     setFocusedState(false);
   };
-
   var onKeyDown = function onKeyDown(event) {
-    if (event.code === 'Space') {
+    if (event.code === 'Space' || event.key === ' ') {
+      // event.key is for Android support
       onClick(event);
     }
   };
-
   var isChecked = function isChecked() {
     return props.checked === props.trueValue;
   };
-
   React__namespace.useImperativeHandle(ref, function () {
     return {
       props: props,
+      focus: function focus() {
+        return utils.DomHandler.focus(inputRef.current);
+      },
       getElement: function getElement() {
         return elementRef.current;
       },

package/checkbox/checkbox.cjs.min.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react"),t=require("primereact/hooks"),n=require("primereact/tooltip"),r=require("primereact/utils");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 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 a=o(e);function l(){return l=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},l.apply(this,arguments)}function c(e){if(Array.isArray(e))return e}function u(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var r,o,a=[],l=!0,c=!1;try{for(n=n.call(e);!(l=(r=n.next()).done)&&(a.push(r.value),!t||a.length!==t);l=!0);}catch(e){c=!0,o=e}finally{try{l||null==n.return||n.return()}finally{if(c)throw o}}return a}}function i(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 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 d(){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 f=a.memo(a.forwardRef((function(e,o){var i,p,b=a.useState(!1),m=(p=2,c(i=b)||u(i,p)||s(i,p)||d()),h=m[0],y=m[1],v=a.useRef(null),g=a.useRef(e.inputRef),k=function(t){if(!e.disabled&&!e.readOnly&&e.onChange){var n=O(),o=t.target instanceof HTMLDivElement||t.target instanceof HTMLSpanElement;if(t.target===g.current||o&&t.target.checked!==n){var a=n?e.falseValue:e.trueValue;e.onChange({originalEvent:t,value:e.value,checked:a,stopPropagation:function(){},preventDefault:function(){},target:{type:"checkbox",name:e.name,id:e.id,value:e.value,checked:a}})}r.DomHandler.focus(g.current),t.preventDefault()}},O=function(){return e.checked===e.trueValue};a.useImperativeHandle(o,(function(){return{props:e,getElement:function(){return v.current},getInput:function(){return g.current}}})),a.useEffect((function(){r.ObjectUtils.combinedRefs(g,e.inputRef)}),[g,e.inputRef]),t.useUpdateEffect((function(){g.current.checked=O()}),[e.checked,e.trueValue]);var x=O(),j=r.ObjectUtils.isNotEmpty(e.tooltip),E=r.ObjectUtils.findDiffKeys(e,f.defaultProps),I=r.ObjectUtils.reduceKeys(E,r.DomHandler.ARIA_PROPS),C=r.classNames("p-checkbox p-component",{"p-checkbox-checked":x,"p-checkbox-disabled":e.disabled,"p-checkbox-focused":h},e.className),w=r.classNames("p-checkbox-box",{"p-highlight":x,"p-disabled":e.disabled,"p-focus":h}),D=r.IconUtils.getJSXIcon(x?e.icon:"",{className:"p-checkbox-icon p-c"},{props:e,checked:x});return a.createElement(a.Fragment,null,a.createElement("div",l({ref:v,id:e.id,className:C,style:e.style},E,{onClick:k,onContextMenu:e.onContextMenu,onMouseDown:e.onMouseDown}),a.createElement("div",{className:"p-hidden-accessible"},a.createElement("input",l({ref:g,type:"checkbox",id:e.inputId,name:e.name,tabIndex:e.tabIndex,defaultChecked:x,onFocus:function(){y(!0)},onBlur:function(){y(!1)},onKeyDown:function(e){"Space"===e.code&&k(e)},disabled:e.disabled,readOnly:e.readOnly,required:e.required},I))),a.createElement("div",{className:w},D)),j&&a.createElement(n.Tooltip,l({target:v,content:e.tooltip},e.tooltipOptions)))})));f.displayName="Checkbox",f.defaultProps={__TYPE:"Checkbox",id:null,inputRef:null,inputId:null,value:null,name:null,checked:!1,trueValue:!0,falseValue:!1,style:null,className:null,disabled:!1,required:!1,readOnly:!1,tabIndex:null,icon:"pi pi-check",tooltip:null,tooltipOptions:null,onChange:null,onMouseDown:null,onContextMenu:null},exports.Checkbox=f;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react"),t=require("primereact/hooks"),n=require("primereact/tooltip"),r=require("primereact/utils");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 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=o(e);function l(){return l=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},l.apply(this,arguments)}function a(e){if(Array.isArray(e))return e}function u(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var r,o,c,l,a=[],u=!0,i=!1;try{if(c=(n=n.call(e)).next,0===t){if(Object(n)!==n)return;u=!1}else for(;!(u=(r=c.call(n)).done)&&(a.push(r.value),a.length!==t);u=!0);}catch(e){i=!0,o=e}finally{try{if(!u&&null!=n.return&&(l=n.return(),Object(l)!==l))return}finally{if(i)throw o}}return a}}function i(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 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 f(){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 d=c.memo(c.forwardRef((function(e,o){var i,p,b=c.useState(!1),m=(p=2,a(i=b)||u(i,p)||s(i,p)||f()),h=m[0],y=m[1],v=c.useRef(null),g=c.useRef(e.inputRef),k=function(t){if(!e.disabled&&!e.readOnly&&e.onChange){var n=O(),o=t.target instanceof HTMLDivElement||t.target instanceof HTMLSpanElement;if(t.target===g.current||o&&t.target.checked!==n){var c=n?e.falseValue:e.trueValue;e.onChange({originalEvent:t,value:e.value,checked:c,stopPropagation:function(){},preventDefault:function(){},target:{type:"checkbox",name:e.name,id:e.id,value:e.value,checked:c}})}r.DomHandler.focus(g.current),t.preventDefault()}},O=function(){return e.checked===e.trueValue};c.useImperativeHandle(o,(function(){return{props:e,focus:function(){return r.DomHandler.focus(g.current)},getElement:function(){return v.current},getInput:function(){return g.current}}})),c.useEffect((function(){r.ObjectUtils.combinedRefs(g,e.inputRef)}),[g,e.inputRef]),t.useUpdateEffect((function(){g.current.checked=O()}),[e.checked,e.trueValue]);var x=O(),j=r.ObjectUtils.isNotEmpty(e.tooltip),E=r.ObjectUtils.findDiffKeys(e,d.defaultProps),I=r.ObjectUtils.reduceKeys(E,r.DomHandler.ARIA_PROPS),C=r.classNames("p-checkbox p-component",{"p-checkbox-checked":x,"p-checkbox-disabled":e.disabled,"p-checkbox-focused":h},e.className),D=r.classNames("p-checkbox-box",{"p-highlight":x,"p-disabled":e.disabled,"p-focus":h}),w=r.IconUtils.getJSXIcon(x?e.icon:"",{className:"p-checkbox-icon p-c"},{props:e,checked:x});return c.createElement(c.Fragment,null,c.createElement("div",l({ref:v,id:e.id,className:C,style:e.style},E,{onClick:k,onContextMenu:e.onContextMenu,onMouseDown:e.onMouseDown}),c.createElement("div",{className:"p-hidden-accessible"},c.createElement("input",l({ref:g,type:"checkbox",id:e.inputId,name:e.name,tabIndex:e.tabIndex,defaultChecked:x,onFocus:function(){y(!0)},onBlur:function(){y(!1)},onKeyDown:function(e){"Space"!==e.code&&" "!==e.key||k(e)},disabled:e.disabled,readOnly:e.readOnly,required:e.required},I))),c.createElement("div",{className:D},w)),j&&c.createElement(n.Tooltip,l({target:v,content:e.tooltip},e.tooltipOptions)))})));d.displayName="Checkbox",d.defaultProps={__TYPE:"Checkbox",id:null,inputRef:null,inputId:null,value:null,name:null,checked:!1,trueValue:!0,falseValue:!1,style:null,className:null,disabled:!1,required:!1,readOnly:!1,tabIndex:null,icon:"pi pi-check",tooltip:null,tooltipOptions:null,onChange:null,onMouseDown:null,onContextMenu:null},exports.Checkbox=d;

package/checkbox/checkbox.d.ts

@@ -1,49 +1,153 @@
+/**
+ *
+ * Checkbox is an extension to standard checkbox element with skinning capabilities.
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/checkbox/)
+ *
+ * @module checkbox
+ *
+ */
 import * as React from 'react';
-import TooltipOptions from '../tooltip/tooltipoptions';
+import { TooltipOptions } from '../tooltip/tooltipoptions';
+import { FormEvent } from '../ts-helpers';
 import { IconType } from '../utils';
 
-interface CheckboxChangeTargetOptions {
-    type: string;
-    name: string;
-    id: string;
-    value: any;
-    checked: boolean;
-}
-
-interface CheckboxChangeParams {
-    originalEvent: React.SyntheticEvent;
-    value: any;
-    checked: boolean;
-    stopPropagation(): void;
-    preventDefault(): void;
-    target: CheckboxChangeTargetOptions;
-}
+/**
+ * Custom change event.
+ * @see {@link CheckboxProps.onChange}
+ * @extends {FormEvent}
+ * @event
+ */
+interface CheckboxChangeEvent extends FormEvent {}
 
+/**
+ * Defines valid properties in Checkbox component. In addition to these, all properties of HTMLDivElement can be used in this component.
+ * @group Properties
+ */
 export interface CheckboxProps extends Omit<React.DetailedHTMLProps<React.InputHTMLAttributes<HTMLDivElement>, HTMLDivElement>, 'onChange' | 'ref'> {
-    id?: string;
-    inputRef?: React.Ref<HTMLInputElement>;
-    inputId?: string;
+    /**
+     * Unique identifier of the element.
+     */
+    id?: string | undefined;
+    /**
+     * Reference of the input element.
+     */
+    inputRef?: React.Ref<HTMLInputElement> | undefined;
+    /**
+     * Identifier of the input element.
+     */
+    inputId?: string | undefined;
+    /**
+     * Value of the component.
+     */
     value?: any;
-    name?: string;
-    checked?: any;
+    /**
+     * Name of the checkbox element .
+     */
+    name?: string | undefined;
+    /**
+     * Specifies whether a checkbox should be checked or not.
+     * @defaultValue false
+     */
+    checked?: boolean | undefined;
+    /**
+     * Value in checked state.
+     * @defaultValue true
+     */
     trueValue?: any;
+    /**
+     * Value in unchecked state.
+     * @defaultValue false
+     */
     falseValue?: any;
-    style?: React.CSSProperties;
-    className?: string;
-    disabled?: boolean;
-    required?: boolean;
-    readOnly?: boolean;
-    tabIndex?: number;
-    icon?: IconType<CheckboxProps>;
-    tooltip?: string;
-    tooltipOptions?: TooltipOptions;
-    onChange?(e: CheckboxChangeParams): void;
+    /**
+     * Inline style of the element.
+     */
+    style?: React.CSSProperties | undefined;
+    /**
+     * Style class of the element.
+     */
+    className?: string | undefined;
+    /**
+     * When present, it specifies that the element value cannot be altered.
+     * @defaultValue false
+     */
+    disabled?: boolean | undefined;
+    /**
+     * When present, it specifies that an input field must be filled out before submitting the form.
+     * @defaultValue false
+     */
+    required?: boolean | undefined;
+    /**
+     * When present, it specifies that the value cannot be changed.
+     * @defaultValue false
+     */
+    readOnly?: boolean | undefined;
+    /**
+     * Index of the element in tabbing order.
+     * @defaultValue false
+     */
+    tabIndex?: number | undefined;
+    /**
+     * Icon class of the checkbox icon.
+     * @defaultValue pi pi-check
+     */
+    icon?: IconType<CheckboxProps> | undefined;
+    /**
+     * Content of the tooltip.
+     */
+    tooltip?: string | undefined;
+    /**
+     * Configuration of the tooltip, refer to the tooltip documentation for more information.
+     * @type {TooltipOptions}
+     */
+    tooltipOptions?: TooltipOptions | undefined;
+    /**
+     * Callback to invoke on value change
+     * @param {CheckboxChangeEvent} event - Custom change event
+     */
+    onChange?(event: CheckboxChangeEvent): void;
+    /**
+     * Callback to invoke to when a mouse button is pressed.
+     * @param {React.MouseEvent<HTMLElement>} event - Browser event
+     */
     onMouseDown?(event: React.MouseEvent<HTMLElement>): void;
+    /**
+     * Callback to invoke on right-click.
+     * @param {React.MouseEvent<HTMLElement>} event - Browser event
+     */
     onContextMenu?(event: React.MouseEvent<HTMLElement>): void;
-    children?: React.ReactNode;
+    /**
+     * Used to get the child elements of the component.
+     * @readonly
+     */
+    children?: React.ReactNode | undefined;
 }
 
+/**
+ * **PrimeReact - Checkbox**
+ *
+ * _Checkbox is an extension to standard checkbox element with skinning capabilities._
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/checkbox/)
+ * --- ---
+ * ![PrimeReact](https://www.primefaces.org/primereact/images/logo-100.png)
+ *
+ * @group Component
+ */
 export declare class Checkbox extends React.Component<CheckboxProps, any> {
+    /**
+     * Used to focus the component.
+     */
+    public focus(): void;
+    /**
+     * Used to get container element.
+     * @return {HTMLDivElement} Container element
+     */
     public getElement(): HTMLDivElement;
+    /**
+     * Used to get input element.
+     * @return {HTMLInputElement} Input element
+     */
     public getInput(): HTMLInputElement;
 }