primereact 9.4.0 → 9.6.0

package/checkbox/checkbox.cjs.js

@@ -7,6 +7,8 @@ var hooks = require('primereact/hooks');
 var check = require('primereact/icons/check');
 var tooltip = require('primereact/tooltip');
 var utils = require('primereact/utils');
+var componentbase = require('primereact/componentbase');
+var api = require('primereact/api');
 
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
@@ -43,6 +45,47 @@ function _extends() {
   return _extends.apply(this, arguments);
 }
 
+function _typeof(obj) {
+  "@babel/helpers - typeof";
+
+  return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) {
+    return typeof obj;
+  } : function (obj) {
+    return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj;
+  }, _typeof(obj);
+}
+
+function _toPrimitive(input, hint) {
+  if (_typeof(input) !== "object" || input === null) return input;
+  var prim = input[Symbol.toPrimitive];
+  if (prim !== undefined) {
+    var res = prim.call(input, hint || "default");
+    if (_typeof(res) !== "object") return res;
+    throw new TypeError("@@toPrimitive must return a primitive value.");
+  }
+  return (hint === "string" ? String : Number)(input);
+}
+
+function _toPropertyKey(arg) {
+  var key = _toPrimitive(arg, "string");
+  return _typeof(key) === "symbol" ? key : String(key);
+}
+
+function _defineProperty(obj, key, value) {
+  key = _toPropertyKey(key);
+  if (key in obj) {
+    Object.defineProperty(obj, key, {
+      value: value,
+      enumerable: true,
+      configurable: true,
+      writable: true
+    });
+  } else {
+    obj[key] = value;
+  }
+  return obj;
+}
+
 function _arrayWithHoles(arr) {
   if (Array.isArray(arr)) return arr;
 }
@@ -98,49 +141,54 @@ function _slicedToArray(arr, i) {
   return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest();
 }
 
-var CheckboxBase = {
+var CheckboxBase = componentbase.ComponentBase.extend({
   defaultProps: {
     __TYPE: 'Checkbox',
-    id: null,
-    inputRef: null,
-    inputId: null,
-    value: null,
-    name: null,
+    autoFocus: false,
     checked: false,
-    trueValue: true,
-    falseValue: false,
-    style: null,
     className: null,
     disabled: false,
-    required: false,
-    readOnly: false,
-    tabIndex: null,
+    falseValue: false,
     icon: null,
-    tooltip: null,
-    tooltipOptions: null,
+    id: null,
+    inputId: null,
+    inputRef: null,
+    name: null,
     onChange: null,
     onClick: null,
-    onMouseDown: null,
     onContextMenu: null,
+    onMouseDown: null,
+    readOnly: false,
+    required: false,
+    style: null,
+    tabIndex: null,
+    tooltip: null,
+    tooltipOptions: null,
+    trueValue: true,
+    value: null,
     children: undefined
-  },
-  getProps: function getProps(props) {
-    return utils.ObjectUtils.getMergedProps(props, CheckboxBase.defaultProps);
-  },
-  getOtherProps: function getOtherProps(props) {
-    return utils.ObjectUtils.getDiffProps(props, CheckboxBase.defaultProps);
   }
-};
+});
 
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
 var Checkbox = /*#__PURE__*/React__namespace.memo( /*#__PURE__*/React__namespace.forwardRef(function (inProps, ref) {
-  var props = CheckboxBase.getProps(inProps);
+  var context = React__namespace.useContext(api.PrimeReactContext);
+  var props = CheckboxBase.getProps(inProps, context);
   var _React$useState = React__namespace.useState(false),
     _React$useState2 = _slicedToArray(_React$useState, 2),
     focusedState = _React$useState2[0],
     setFocusedState = _React$useState2[1];
+  var _CheckboxBase$setMeta = CheckboxBase.setMetaData({
+      props: props,
+      state: {
+        focused: focusedState
+      }
+    }),
+    ptm = _CheckboxBase$setMeta.ptm;
   var elementRef = React__namespace.useRef(null);
   var inputRef = React__namespace.useRef(props.inputRef);
-  var onClick = function onClick(event) {
+  var _onClick = function onClick(event) {
     if (props.disabled || props.readOnly) {
       return;
     }
@@ -181,16 +229,16 @@ var Checkbox = /*#__PURE__*/React__namespace.memo( /*#__PURE__*/React__namespace
       event.preventDefault();
     }
   };
-  var onFocus = function onFocus() {
+  var _onFocus = function onFocus() {
     setFocusedState(true);
   };
-  var onBlur = function onBlur() {
+  var _onBlur = function onBlur() {
     setFocusedState(false);
   };
-  var onKeyDown = function onKeyDown(event) {
+  var _onKeyDown = function onKeyDown(event) {
     if (event.code === 'Space' || event.key === ' ') {
       // event.key is for Android support
-      onClick(event);
+      _onClick(event);
     }
   };
   var isChecked = function isChecked() {
@@ -216,6 +264,11 @@ var Checkbox = /*#__PURE__*/React__namespace.memo( /*#__PURE__*/React__namespace
   hooks.useUpdateEffect(function () {
     inputRef.current.checked = isChecked();
   }, [props.checked, props.trueValue]);
+  hooks.useMountEffect(function () {
+    if (props.autoFocus) {
+      utils.DomHandler.focus(inputRef.current, props.autoFocus);
+    }
+  });
   var checked = isChecked();
   var hasTooltip = utils.ObjectUtils.isNotEmpty(props.tooltip);
   var otherProps = CheckboxBase.getOtherProps(props);
@@ -231,45 +284,57 @@ var Checkbox = /*#__PURE__*/React__namespace.memo( /*#__PURE__*/React__namespace
     'p-focus': focusedState
   });
   var iconClassName = 'p-checkbox-icon p-c';
-  var icon = checked ? props.icon || /*#__PURE__*/React__namespace.createElement(check.CheckIcon, {
-    className: iconClassName
-  }) : null;
-  var checkboxIcon = utils.IconUtils.getJSXIcon(icon, {
+  var iconProps = utils.mergeProps({
     className: iconClassName
-  }, {
+  }, ptm('icon'));
+  var icon = checked ? props.icon || /*#__PURE__*/React__namespace.createElement(check.CheckIcon, iconProps) : null;
+  var checkboxIcon = utils.IconUtils.getJSXIcon(icon, _objectSpread({}, iconProps), {
     props: props,
     checked: checked
   });
-  return /*#__PURE__*/React__namespace.createElement(React__namespace.Fragment, null, /*#__PURE__*/React__namespace.createElement("div", _extends({
+  var rootProps = utils.mergeProps({
     ref: elementRef,
     id: props.id,
     className: className,
-    style: props.style
-  }, otherProps, {
-    onPointerUp: onClick,
+    style: props.style,
+    onClick: function onClick(e) {
+      return _onClick(e);
+    },
     onContextMenu: props.onContextMenu,
     onMouseDown: props.onMouseDown
-  }), /*#__PURE__*/React__namespace.createElement("div", {
-    className: "p-hidden-accessible"
-  }, /*#__PURE__*/React__namespace.createElement("input", _extends({
-    ref: inputRef,
-    type: "checkbox",
+  }, otherProps, ptm('root'));
+  var hiddenInputWrapperProps = utils.mergeProps({
+    className: 'p-hidden-accessible'
+  }, ptm('hiddenInputWrapper'));
+  var hiddenInputProps = utils.mergeProps(_objectSpread({
     id: props.inputId,
+    ref: inputRef,
+    type: 'checkbox',
     name: props.name,
     tabIndex: props.tabIndex,
     defaultChecked: checked,
-    onFocus: onFocus,
-    onBlur: onBlur,
-    onKeyDown: onKeyDown,
+    onFocus: function onFocus(e) {
+      return _onFocus();
+    },
+    onBlur: function onBlur(e) {
+      return _onBlur();
+    },
+    onKeyDown: function onKeyDown(e) {
+      return _onKeyDown(e);
+    },
     disabled: props.disabled,
     readOnly: props.readOnly,
     required: props.required
-  }, ariaProps))), /*#__PURE__*/React__namespace.createElement("div", {
+  }, ariaProps), ptm('hiddenInput'));
+  var inputProps = utils.mergeProps({
     className: boxClass
-  }, checkboxIcon)), hasTooltip && /*#__PURE__*/React__namespace.createElement(tooltip.Tooltip, _extends({
+  }, ptm('input'));
+  return /*#__PURE__*/React__namespace.createElement(React__namespace.Fragment, null, /*#__PURE__*/React__namespace.createElement("div", rootProps, /*#__PURE__*/React__namespace.createElement("div", hiddenInputWrapperProps, /*#__PURE__*/React__namespace.createElement("input", hiddenInputProps)), /*#__PURE__*/React__namespace.createElement("div", inputProps, checkboxIcon)), hasTooltip && /*#__PURE__*/React__namespace.createElement(tooltip.Tooltip, _extends({
     target: elementRef,
     content: props.tooltip
-  }, props.tooltipOptions)));
+  }, props.tooltipOptions, {
+    pt: ptm('tooltip')
+  })));
 }));
 Checkbox.displayName = 'Checkbox';
 

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/icons/check"),r=require("primereact/tooltip"),o=require("primereact/utils");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);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 r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e},a.apply(this,arguments)}function u(e){if(Array.isArray(e))return e}function i(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var r,o,l,c,a=[],u=!0,i=!1;try{if(l=(n=n.call(e)).next,0===t){if(Object(n)!==n)return;u=!1}else for(;!(u=(r=l.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&&(c=n.return(),Object(c)!==c))return}finally{if(i)throw o}}return a}}function s(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 f(e,t){if(e){if("string"==typeof e)return s(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)?s(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 p={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:null,tooltip:null,tooltipOptions:null,onChange:null,onClick:null,onMouseDown:null,onContextMenu:null,children:void 0},getProps:function(e){return o.ObjectUtils.getMergedProps(e,p.defaultProps)},getOtherProps:function(e){return o.ObjectUtils.getDiffProps(e,p.defaultProps)}},b=c.memo(c.forwardRef((function(e,l){var s,b,m=p.getProps(e),h=c.useState(!1),g=(b=2,u(s=h)||i(s,b)||f(s,b)||d()),y=g[0],v=g[1],k=c.useRef(null),O=c.useRef(m.inputRef),x=function(e){if(!m.disabled&&!m.readOnly&&(m.onChange||m.onClick)){var t=j(),n=e.target instanceof HTMLDivElement||e.target instanceof HTMLSpanElement||e.target instanceof Object;if(e.target===O.current||n&&e.target.checked!==t){var r=t?m.falseValue:m.trueValue,l={originalEvent:e,value:m.value,checked:r,stopPropagation:function(){e.stopPropagation()},preventDefault:function(){e.preventDefault()},target:{type:"checkbox",name:m.name,id:m.id,value:m.value,checked:r}};if(m.onClick&&m.onClick(l),e.defaultPrevented)return;m.onChange&&m.onChange(l)}o.DomHandler.focus(O.current),e.preventDefault()}},j=function(){return m.checked===m.trueValue};c.useImperativeHandle(l,(function(){return{props:m,focus:function(){return o.DomHandler.focus(O.current)},getElement:function(){return k.current},getInput:function(){return O.current}}})),c.useEffect((function(){o.ObjectUtils.combinedRefs(O,m.inputRef)}),[O,m.inputRef]),t.useUpdateEffect((function(){O.current.checked=j()}),[m.checked,m.trueValue]);var P=j(),C=o.ObjectUtils.isNotEmpty(m.tooltip),E=p.getOtherProps(m),I=o.ObjectUtils.reduceKeys(E,o.DomHandler.ARIA_PROPS),D=o.classNames("p-checkbox p-component",{"p-checkbox-checked":P,"p-checkbox-disabled":m.disabled,"p-checkbox-focused":y},m.className),M=o.classNames("p-checkbox-box",{"p-highlight":P,"p-disabled":m.disabled,"p-focus":y}),w="p-checkbox-icon p-c",N=o.IconUtils.getJSXIcon(P?m.icon||c.createElement(n.CheckIcon,{className:w}):null,{className:w},{props:m,checked:P});return c.createElement(c.Fragment,null,c.createElement("div",a({ref:k,id:m.id,className:D,style:m.style},E,{onPointerUp:x,onContextMenu:m.onContextMenu,onMouseDown:m.onMouseDown}),c.createElement("div",{className:"p-hidden-accessible"},c.createElement("input",a({ref:O,type:"checkbox",id:m.inputId,name:m.name,tabIndex:m.tabIndex,defaultChecked:P,onFocus:function(){v(!0)},onBlur:function(){v(!1)},onKeyDown:function(e){"Space"!==e.code&&" "!==e.key||x(e)},disabled:m.disabled,readOnly:m.readOnly,required:m.required},I))),c.createElement("div",{className:M},N)),C&&c.createElement(r.Tooltip,a({target:k,content:m.tooltip},m.tooltipOptions)))})));b.displayName="Checkbox",exports.Checkbox=b;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react"),t=require("primereact/hooks"),r=require("primereact/icons/check"),n=require("primereact/tooltip"),o=require("primereact/utils"),c=require("primereact/componentbase"),u=require("primereact/api");function i(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=i(e);function l(){return l=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},l.apply(this,arguments)}function s(e){return s="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},s(e)}function f(e,t){if("object"!==s(e)||null===e)return e;var r=e[Symbol.toPrimitive];if(void 0!==r){var n=r.call(e,t||"default");if("object"!==s(n))return n;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===t?String:Number)(e)}function p(e){var t=f(e,"string");return"symbol"===s(t)?t:String(t)}function d(e,t,r){return(t=p(t))in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function b(e){if(Array.isArray(e))return e}function m(e,t){var r=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=r){var n,o,c,u,i=[],a=!0,l=!1;try{if(c=(r=r.call(e)).next,0===t){if(Object(r)!==r)return;a=!1}else for(;!(a=(n=c.call(r)).done)&&(i.push(n.value),i.length!==t);a=!0);}catch(e){l=!0,o=e}finally{try{if(!a&&null!=r.return&&(u=r.return(),Object(u)!==u))return}finally{if(l)throw o}}return i}}function y(e,t){(null==t||t>e.length)&&(t=e.length);for(var r=0,n=new Array(t);r<t;r++)n[r]=e[r];return n}function h(e,t){if(e){if("string"==typeof e)return y(e,t);var r=Object.prototype.toString.call(e).slice(8,-1);return"Object"===r&&e.constructor&&(r=e.constructor.name),"Map"===r||"Set"===r?Array.from(e):"Arguments"===r||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(r)?y(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.")}var g=c.ComponentBase.extend({defaultProps:{__TYPE:"Checkbox",autoFocus:!1,checked:!1,className:null,disabled:!1,falseValue:!1,icon:null,id:null,inputId:null,inputRef:null,name:null,onChange:null,onClick:null,onContextMenu:null,onMouseDown:null,readOnly:!1,required:!1,style:null,tabIndex:null,tooltip:null,tooltipOptions:null,trueValue:!0,value:null,children:void 0}});function O(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function j(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{};t%2?O(Object(r),!0).forEach((function(t){d(e,t,r[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):O(Object(r)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))}))}return e}var k=a.memo(a.forwardRef((function(e,c){var i,s,f=a.useContext(u.PrimeReactContext),p=g.getProps(e,f),d=a.useState(!1),y=(s=2,b(i=d)||m(i,s)||h(i,s)||v()),O=y[0],k=y[1],P=g.setMetaData({props:p,state:{focused:O}}).ptm,x=a.useRef(null),C=a.useRef(p.inputRef),E=function(e){if(!p.disabled&&!p.readOnly&&(p.onChange||p.onClick)){var t=w(),r=e.target instanceof HTMLDivElement||e.target instanceof HTMLSpanElement||e.target instanceof Object;if(e.target===C.current||r&&e.target.checked!==t){var n=t?p.falseValue:p.trueValue,c={originalEvent:e,value:p.value,checked:n,stopPropagation:function(){e.stopPropagation()},preventDefault:function(){e.preventDefault()},target:{type:"checkbox",name:p.name,id:p.id,value:p.value,checked:n}};if(p.onClick&&p.onClick(c),e.defaultPrevented)return;p.onChange&&p.onChange(c)}o.DomHandler.focus(C.current),e.preventDefault()}},w=function(){return p.checked===p.trueValue};a.useImperativeHandle(c,(function(){return{props:p,focus:function(){return o.DomHandler.focus(C.current)},getElement:function(){return x.current},getInput:function(){return C.current}}})),a.useEffect((function(){o.ObjectUtils.combinedRefs(C,p.inputRef)}),[C,p.inputRef]),t.useUpdateEffect((function(){C.current.checked=w()}),[p.checked,p.trueValue]),t.useMountEffect((function(){p.autoFocus&&o.DomHandler.focus(C.current,p.autoFocus)}));var S=w(),D=o.ObjectUtils.isNotEmpty(p.tooltip),I=g.getOtherProps(p),M=o.ObjectUtils.reduceKeys(I,o.DomHandler.ARIA_PROPS),N=o.classNames("p-checkbox p-component",{"p-checkbox-checked":S,"p-checkbox-disabled":p.disabled,"p-checkbox-focused":O},p.className),R=o.classNames("p-checkbox-box",{"p-highlight":S,"p-disabled":p.disabled,"p-focus":O}),q=o.mergeProps({className:"p-checkbox-icon p-c"},P("icon")),A=o.IconUtils.getJSXIcon(S?p.icon||a.createElement(r.CheckIcon,q):null,j({},q),{props:p,checked:S}),H=o.mergeProps({ref:x,id:p.id,className:N,style:p.style,onClick:function(e){return E(e)},onContextMenu:p.onContextMenu,onMouseDown:p.onMouseDown},I,P("root")),_=o.mergeProps({className:"p-hidden-accessible"},P("hiddenInputWrapper")),T=o.mergeProps(j({id:p.inputId,ref:C,type:"checkbox",name:p.name,tabIndex:p.tabIndex,defaultChecked:S,onFocus:function(e){k(!0)},onBlur:function(e){k(!1)},onKeyDown:function(e){var t;"Space"!==(t=e).code&&" "!==t.key||E(t)},disabled:p.disabled,readOnly:p.readOnly,required:p.required},M),P("hiddenInput")),U=o.mergeProps({className:R},P("input"));return a.createElement(a.Fragment,null,a.createElement("div",H,a.createElement("div",_,a.createElement("input",T)),a.createElement("div",U,A)),D&&a.createElement(n.Tooltip,l({target:x,content:p.tooltip},p.tooltipOptions,{pt:P("tooltip")})))})));k.displayName="Checkbox",exports.Checkbox=k;

package/checkbox/checkbox.d.ts

@@ -10,7 +10,61 @@
 import * as React from 'react';
 import { TooltipOptions } from '../tooltip/tooltipoptions';
 import { FormEvent } from '../ts-helpers';
-import { IconType } from '../utils';
+import { IconType, PassThroughType } from '../utils';
+import { TooltipPassThroughOptions } from '../tooltip/tooltip';
+
+export declare type CheckboxPassThroughType<T> = PassThroughType<T, CheckboxPassThroughMethodOptions>;
+
+/**
+ * Custom passthrough(pt) option method.
+ */
+export interface CheckboxPassThroughMethodOptions {
+    props: CheckboxProps;
+    state: CheckboxState;
+}
+
+/**
+ * Custom passthrough(pt) options.
+ * @see {@link CheckboxProps.pt}
+ */
+export interface CheckboxPassThroughOptions {
+    /**
+     * Uses to pass attributes to the root's DOM element.
+     */
+    root?: CheckboxPassThroughType<React.HTMLAttributes<HTMLDivElement>>;
+    /**
+     * Uses to pass attributes to the input's DOM element.
+     */
+    input?: CheckboxPassThroughType<React.HTMLAttributes<HTMLDivElement>>;
+    /**
+     * Uses to pass attributes to the icon's DOM element.
+     */
+    icon?: CheckboxPassThroughType<React.SVGProps<SVGSVGElement> | React.HTMLAttributes<HTMLSpanElement>>;
+    /**
+     * Uses to pass attributes tooltip's DOM element.
+     * @type {TooltipPassThroughOptions}
+     */
+    tooltip?: TooltipPassThroughOptions;
+    /**
+     * Uses to pass attributes to the hidden input wrapper's DOM element.
+     */
+    hiddenInputWrapper?: CheckboxPassThroughType<React.HTMLAttributes<HTMLDivElement>>;
+    /**
+     * Uses to pass attributes to the hidden input's DOM element.
+     */
+    hiddenInput?: CheckboxPassThroughType<React.HTMLAttributes<HTMLInputElement>>;
+}
+
+/**
+ * Defines current inline state in Checkbox component.
+ */
+export interface CheckboxState {
+    /**
+     * Current focus state as a boolean.
+     * @defaultValue false
+     */
+    focused: boolean;
+}
 
 /**
  * Custom change event.
@@ -37,6 +91,11 @@ export interface CheckboxProps extends Omit<React.DetailedHTMLProps<React.InputH
      * Unique identifier of the element.
      */
     id?: string | undefined;
+    /**
+     * When present, it specifies that the component should automatically get focus on load.
+     * @defaultValue false
+     */
+    autoFocus?: boolean | undefined;
     /**
      * Reference of the input element.
      */
@@ -134,6 +193,11 @@ export interface CheckboxProps extends Omit<React.DetailedHTMLProps<React.InputH
      * @readonly
      */
     children?: React.ReactNode | undefined;
+    /**
+     * Uses to pass attributes to DOM elements inside the component.
+     * @type {CheckboxPassThroughOptions}
+     */
+    pt?: CheckboxPassThroughOptions;
 }
 
 /**

package/checkbox/checkbox.esm.js

@@ -1,8 +1,10 @@
 import * as React from 'react';
-import { useUpdateEffect } from 'primereact/hooks';
+import { useUpdateEffect, useMountEffect } from 'primereact/hooks';
 import { CheckIcon } from 'primereact/icons/check';
 import { Tooltip } from 'primereact/tooltip';
-import { ObjectUtils, DomHandler, classNames, IconUtils } from 'primereact/utils';
+import { DomHandler, ObjectUtils, classNames, mergeProps, IconUtils } from 'primereact/utils';
+import { ComponentBase } from 'primereact/componentbase';
+import { PrimeReactContext } from 'primereact/api';
 
 function _extends() {
   _extends = Object.assign ? Object.assign.bind() : function (target) {
@@ -19,6 +21,47 @@ function _extends() {
   return _extends.apply(this, arguments);
 }
 
+function _typeof(obj) {
+  "@babel/helpers - typeof";
+
+  return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) {
+    return typeof obj;
+  } : function (obj) {
+    return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj;
+  }, _typeof(obj);
+}
+
+function _toPrimitive(input, hint) {
+  if (_typeof(input) !== "object" || input === null) return input;
+  var prim = input[Symbol.toPrimitive];
+  if (prim !== undefined) {
+    var res = prim.call(input, hint || "default");
+    if (_typeof(res) !== "object") return res;
+    throw new TypeError("@@toPrimitive must return a primitive value.");
+  }
+  return (hint === "string" ? String : Number)(input);
+}
+
+function _toPropertyKey(arg) {
+  var key = _toPrimitive(arg, "string");
+  return _typeof(key) === "symbol" ? key : String(key);
+}
+
+function _defineProperty(obj, key, value) {
+  key = _toPropertyKey(key);
+  if (key in obj) {
+    Object.defineProperty(obj, key, {
+      value: value,
+      enumerable: true,
+      configurable: true,
+      writable: true
+    });
+  } else {
+    obj[key] = value;
+  }
+  return obj;
+}
+
 function _arrayWithHoles(arr) {
   if (Array.isArray(arr)) return arr;
 }
@@ -74,49 +117,54 @@ function _slicedToArray(arr, i) {
   return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest();
 }
 
-var CheckboxBase = {
+var CheckboxBase = ComponentBase.extend({
   defaultProps: {
     __TYPE: 'Checkbox',
-    id: null,
-    inputRef: null,
-    inputId: null,
-    value: null,
-    name: null,
+    autoFocus: false,
     checked: false,
-    trueValue: true,
-    falseValue: false,
-    style: null,
     className: null,
     disabled: false,
-    required: false,
-    readOnly: false,
-    tabIndex: null,
+    falseValue: false,
     icon: null,
-    tooltip: null,
-    tooltipOptions: null,
+    id: null,
+    inputId: null,
+    inputRef: null,
+    name: null,
     onChange: null,
     onClick: null,
-    onMouseDown: null,
     onContextMenu: null,
+    onMouseDown: null,
+    readOnly: false,
+    required: false,
+    style: null,
+    tabIndex: null,
+    tooltip: null,
+    tooltipOptions: null,
+    trueValue: true,
+    value: null,
     children: undefined
-  },
-  getProps: function getProps(props) {
-    return ObjectUtils.getMergedProps(props, CheckboxBase.defaultProps);
-  },
-  getOtherProps: function getOtherProps(props) {
-    return ObjectUtils.getDiffProps(props, CheckboxBase.defaultProps);
   }
-};
+});
 
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
 var Checkbox = /*#__PURE__*/React.memo( /*#__PURE__*/React.forwardRef(function (inProps, ref) {
-  var props = CheckboxBase.getProps(inProps);
+  var context = React.useContext(PrimeReactContext);
+  var props = CheckboxBase.getProps(inProps, context);
   var _React$useState = React.useState(false),
     _React$useState2 = _slicedToArray(_React$useState, 2),
     focusedState = _React$useState2[0],
     setFocusedState = _React$useState2[1];
+  var _CheckboxBase$setMeta = CheckboxBase.setMetaData({
+      props: props,
+      state: {
+        focused: focusedState
+      }
+    }),
+    ptm = _CheckboxBase$setMeta.ptm;
   var elementRef = React.useRef(null);
   var inputRef = React.useRef(props.inputRef);
-  var onClick = function onClick(event) {
+  var _onClick = function onClick(event) {
     if (props.disabled || props.readOnly) {
       return;
     }
@@ -157,16 +205,16 @@ var Checkbox = /*#__PURE__*/React.memo( /*#__PURE__*/React.forwardRef(function (
       event.preventDefault();
     }
   };
-  var onFocus = function onFocus() {
+  var _onFocus = function onFocus() {
     setFocusedState(true);
   };
-  var onBlur = function onBlur() {
+  var _onBlur = function onBlur() {
     setFocusedState(false);
   };
-  var onKeyDown = function onKeyDown(event) {
+  var _onKeyDown = function onKeyDown(event) {
     if (event.code === 'Space' || event.key === ' ') {
       // event.key is for Android support
-      onClick(event);
+      _onClick(event);
     }
   };
   var isChecked = function isChecked() {
@@ -192,6 +240,11 @@ var Checkbox = /*#__PURE__*/React.memo( /*#__PURE__*/React.forwardRef(function (
   useUpdateEffect(function () {
     inputRef.current.checked = isChecked();
   }, [props.checked, props.trueValue]);
+  useMountEffect(function () {
+    if (props.autoFocus) {
+      DomHandler.focus(inputRef.current, props.autoFocus);
+    }
+  });
   var checked = isChecked();
   var hasTooltip = ObjectUtils.isNotEmpty(props.tooltip);
   var otherProps = CheckboxBase.getOtherProps(props);
@@ -207,45 +260,57 @@ var Checkbox = /*#__PURE__*/React.memo( /*#__PURE__*/React.forwardRef(function (
     'p-focus': focusedState
   });
   var iconClassName = 'p-checkbox-icon p-c';
-  var icon = checked ? props.icon || /*#__PURE__*/React.createElement(CheckIcon, {
-    className: iconClassName
-  }) : null;
-  var checkboxIcon = IconUtils.getJSXIcon(icon, {
+  var iconProps = mergeProps({
     className: iconClassName
-  }, {
+  }, ptm('icon'));
+  var icon = checked ? props.icon || /*#__PURE__*/React.createElement(CheckIcon, iconProps) : null;
+  var checkboxIcon = IconUtils.getJSXIcon(icon, _objectSpread({}, iconProps), {
     props: props,
     checked: checked
   });
-  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("div", _extends({
+  var rootProps = mergeProps({
     ref: elementRef,
     id: props.id,
     className: className,
-    style: props.style
-  }, otherProps, {
-    onPointerUp: onClick,
+    style: props.style,
+    onClick: function onClick(e) {
+      return _onClick(e);
+    },
     onContextMenu: props.onContextMenu,
     onMouseDown: props.onMouseDown
-  }), /*#__PURE__*/React.createElement("div", {
-    className: "p-hidden-accessible"
-  }, /*#__PURE__*/React.createElement("input", _extends({
-    ref: inputRef,
-    type: "checkbox",
+  }, otherProps, ptm('root'));
+  var hiddenInputWrapperProps = mergeProps({
+    className: 'p-hidden-accessible'
+  }, ptm('hiddenInputWrapper'));
+  var hiddenInputProps = mergeProps(_objectSpread({
     id: props.inputId,
+    ref: inputRef,
+    type: 'checkbox',
     name: props.name,
     tabIndex: props.tabIndex,
     defaultChecked: checked,
-    onFocus: onFocus,
-    onBlur: onBlur,
-    onKeyDown: onKeyDown,
+    onFocus: function onFocus(e) {
+      return _onFocus();
+    },
+    onBlur: function onBlur(e) {
+      return _onBlur();
+    },
+    onKeyDown: function onKeyDown(e) {
+      return _onKeyDown(e);
+    },
     disabled: props.disabled,
     readOnly: props.readOnly,
     required: props.required
-  }, ariaProps))), /*#__PURE__*/React.createElement("div", {
+  }, ariaProps), ptm('hiddenInput'));
+  var inputProps = mergeProps({
     className: boxClass
-  }, checkboxIcon)), hasTooltip && /*#__PURE__*/React.createElement(Tooltip, _extends({
+  }, ptm('input'));
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("div", rootProps, /*#__PURE__*/React.createElement("div", hiddenInputWrapperProps, /*#__PURE__*/React.createElement("input", hiddenInputProps)), /*#__PURE__*/React.createElement("div", inputProps, checkboxIcon)), hasTooltip && /*#__PURE__*/React.createElement(Tooltip, _extends({
     target: elementRef,
     content: props.tooltip
-  }, props.tooltipOptions)));
+  }, props.tooltipOptions, {
+    pt: ptm('tooltip')
+  })));
 }));
 Checkbox.displayName = 'Checkbox';
 

package/checkbox/checkbox.esm.min.js

@@ -1 +1 @@
-import*as e from"react";import{useUpdateEffect as t}from"primereact/hooks";import{CheckIcon as n}from"primereact/icons/check";import{Tooltip as r}from"primereact/tooltip";import{ObjectUtils as o,DomHandler as l,classNames as a,IconUtils as c}from"primereact/utils";function u(){return u=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},u.apply(this,arguments)}function i(e){if(Array.isArray(e))return e}function s(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var r,o,l,a,c=[],u=!0,i=!1;try{if(l=(n=n.call(e)).next,0===t){if(Object(n)!==n)return;u=!1}else for(;!(u=(r=l.call(n)).done)&&(c.push(r.value),c.length!==t);u=!0);}catch(e){i=!0,o=e}finally{try{if(!u&&null!=n.return&&(a=n.return(),Object(a)!==a))return}finally{if(i)throw o}}return c}}function f(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 p(e,t){if(e){if("string"==typeof e)return f(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)?f(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 m={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:null,tooltip:null,tooltipOptions:null,onChange:null,onClick:null,onMouseDown:null,onContextMenu:null,children:void 0},getProps:function(e){return o.getMergedProps(e,m.defaultProps)},getOtherProps:function(e){return o.getDiffProps(e,m.defaultProps)}},h=e.memo(e.forwardRef((function(f,h){var b,g,y=m.getProps(f),v=e.useState(!1),k=(g=2,i(b=v)||s(b,g)||p(b,g)||d()),x=k[0],O=k[1],P=e.useRef(null),C=e.useRef(y.inputRef),E=function(e){if(!y.disabled&&!y.readOnly&&(y.onChange||y.onClick)){var t=I(),n=e.target instanceof HTMLDivElement||e.target instanceof HTMLSpanElement||e.target instanceof Object;if(e.target===C.current||n&&e.target.checked!==t){var r=t?y.falseValue:y.trueValue,o={originalEvent:e,value:y.value,checked:r,stopPropagation:function(){e.stopPropagation()},preventDefault:function(){e.preventDefault()},target:{type:"checkbox",name:y.name,id:y.id,value:y.value,checked:r}};if(y.onClick&&y.onClick(o),e.defaultPrevented)return;y.onChange&&y.onChange(o)}l.focus(C.current),e.preventDefault()}},I=function(){return y.checked===y.trueValue};e.useImperativeHandle(h,(function(){return{props:y,focus:function(){return l.focus(C.current)},getElement:function(){return P.current},getInput:function(){return C.current}}})),e.useEffect((function(){o.combinedRefs(C,y.inputRef)}),[C,y.inputRef]),t((function(){C.current.checked=I()}),[y.checked,y.trueValue]);var w=I(),M=o.isNotEmpty(y.tooltip),R=m.getOtherProps(y),S=o.reduceKeys(R,l.ARIA_PROPS),j=a("p-checkbox p-component",{"p-checkbox-checked":w,"p-checkbox-disabled":y.disabled,"p-checkbox-focused":x},y.className),D=a("p-checkbox-box",{"p-highlight":w,"p-disabled":y.disabled,"p-focus":x}),N="p-checkbox-icon p-c",A=c.getJSXIcon(w?y.icon||e.createElement(n,{className:N}):null,{className:N},{props:y,checked:w});return e.createElement(e.Fragment,null,e.createElement("div",u({ref:P,id:y.id,className:j,style:y.style},R,{onPointerUp:E,onContextMenu:y.onContextMenu,onMouseDown:y.onMouseDown}),e.createElement("div",{className:"p-hidden-accessible"},e.createElement("input",u({ref:C,type:"checkbox",id:y.inputId,name:y.name,tabIndex:y.tabIndex,defaultChecked:w,onFocus:function(){O(!0)},onBlur:function(){O(!1)},onKeyDown:function(e){"Space"!==e.code&&" "!==e.key||E(e)},disabled:y.disabled,readOnly:y.readOnly,required:y.required},S))),e.createElement("div",{className:D},A)),M&&e.createElement(r,u({target:P,content:y.tooltip},y.tooltipOptions)))})));h.displayName="Checkbox";export{h as Checkbox};
+import*as e from"react";import{useUpdateEffect as t,useMountEffect as n}from"primereact/hooks";import{CheckIcon as r}from"primereact/icons/check";import{Tooltip as o}from"primereact/tooltip";import{DomHandler as c,ObjectUtils as u,classNames as i,mergeProps as a,IconUtils as l}from"primereact/utils";import{ComponentBase as p}from"primereact/componentbase";import{PrimeReactContext as f}from"primereact/api";function s(){return s=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},s.apply(this,arguments)}function d(e){return d="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},d(e)}function m(e,t){if("object"!==d(e)||null===e)return e;var n=e[Symbol.toPrimitive];if(void 0!==n){var r=n.call(e,t||"default");if("object"!==d(r))return r;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===t?String:Number)(e)}function b(e){var t=m(e,"string");return"symbol"===d(t)?t:String(t)}function y(e,t,n){return(t=b(t))in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function h(e){if(Array.isArray(e))return e}function v(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var r,o,c,u,i=[],a=!0,l=!1;try{if(c=(n=n.call(e)).next,0===t){if(Object(n)!==n)return;a=!1}else for(;!(a=(r=c.call(n)).done)&&(i.push(r.value),i.length!==t);a=!0);}catch(e){l=!0,o=e}finally{try{if(!a&&null!=n.return&&(u=n.return(),Object(u)!==u))return}finally{if(l)throw o}}return i}}function g(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 O(e,t){if(e){if("string"==typeof e)return g(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)?g(e,t):void 0}}function k(){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 j=p.extend({defaultProps:{__TYPE:"Checkbox",autoFocus:!1,checked:!1,className:null,disabled:!1,falseValue:!1,icon:null,id:null,inputId:null,inputRef:null,name:null,onChange:null,onClick:null,onContextMenu:null,onMouseDown:null,readOnly:!1,required:!1,style:null,tabIndex:null,tooltip:null,tooltipOptions:null,trueValue:!0,value:null,children:void 0}});function x(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 P(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?x(Object(n),!0).forEach((function(t){y(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):x(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}var S=e.memo(e.forwardRef((function(p,d){var m,b,y=e.useContext(f),g=j.getProps(p,y),x=e.useState(!1),S=(b=2,h(m=x)||v(m,b)||O(m,b)||k()),w=S[0],E=S[1],C=j.setMetaData({props:g,state:{focused:w}}).ptm,I=e.useRef(null),D=e.useRef(g.inputRef),M=function(e){if(!g.disabled&&!g.readOnly&&(g.onChange||g.onClick)){var t=R(),n=e.target instanceof HTMLDivElement||e.target instanceof HTMLSpanElement||e.target instanceof Object;if(e.target===D.current||n&&e.target.checked!==t){var r=t?g.falseValue:g.trueValue,o={originalEvent:e,value:g.value,checked:r,stopPropagation:function(){e.stopPropagation()},preventDefault:function(){e.preventDefault()},target:{type:"checkbox",name:g.name,id:g.id,value:g.value,checked:r}};if(g.onClick&&g.onClick(o),e.defaultPrevented)return;g.onChange&&g.onChange(o)}c.focus(D.current),e.preventDefault()}},R=function(){return g.checked===g.trueValue};e.useImperativeHandle(d,(function(){return{props:g,focus:function(){return c.focus(D.current)},getElement:function(){return I.current},getInput:function(){return D.current}}})),e.useEffect((function(){u.combinedRefs(D,g.inputRef)}),[D,g.inputRef]),t((function(){D.current.checked=R()}),[g.checked,g.trueValue]),n((function(){g.autoFocus&&c.focus(D.current,g.autoFocus)}));var N=R(),A=u.isNotEmpty(g.tooltip),V=j.getOtherProps(g),F=u.reduceKeys(V,c.ARIA_PROPS),T=i("p-checkbox p-component",{"p-checkbox-checked":N,"p-checkbox-disabled":g.disabled,"p-checkbox-focused":w},g.className),q=i("p-checkbox-box",{"p-highlight":N,"p-disabled":g.disabled,"p-focus":w}),H=a({className:"p-checkbox-icon p-c"},C("icon")),_=l.getJSXIcon(N?g.icon||e.createElement(r,H):null,P({},H),{props:g,checked:N}),K=a({ref:I,id:g.id,className:T,style:g.style,onClick:function(e){return M(e)},onContextMenu:g.onContextMenu,onMouseDown:g.onMouseDown},V,C("root")),L=a({className:"p-hidden-accessible"},C("hiddenInputWrapper")),B=a(P({id:g.inputId,ref:D,type:"checkbox",name:g.name,tabIndex:g.tabIndex,defaultChecked:N,onFocus:function(e){E(!0)},onBlur:function(e){E(!1)},onKeyDown:function(e){var t;"Space"!==(t=e).code&&" "!==t.key||M(t)},disabled:g.disabled,readOnly:g.readOnly,required:g.required},F),C("hiddenInput")),J=a({className:q},C("input"));return e.createElement(e.Fragment,null,e.createElement("div",K,e.createElement("div",L,e.createElement("input",B)),e.createElement("div",J,_)),A&&e.createElement(o,s({target:I,content:g.tooltip},g.tooltipOptions,{pt:C("tooltip")})))})));S.displayName="Checkbox";export{S as Checkbox};