primereact 8.7.3 → 9.0.0-beta.1

package/progressbar/progressbar.d.ts

@@ -1,19 +1,68 @@
+/**
+ *
+ * ProgressBar is a process status indicator.
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/progressbar)
+ *
+ * @module progressbar
+ *
+ */
 import * as React from 'react';
 
-type ProgressBarModeType = 'determinate' | 'indeterminate';
-
-type ProgressBarValueType = string | number | undefined | null;
-
+/**
+ * Defines valid properties in ProgressBar component. In addition to these, all properties of HTMLDivElement can be used in this component.
+ * @group Properties
+ */
 export interface ProgressBarProps extends Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, 'ref'> {
-    value?: ProgressBarValueType;
-    showValue?: boolean;
-    unit?: string;
-    mode?: ProgressBarModeType;
-    color?: string;
-    displayValueTemplate?(value: ProgressBarValueType): React.ReactNode;
-    children?: React.ReactNode;
+    /**
+     * Current value of the progress.
+     */
+    value?: string | number | null | undefined;
+    /**
+     * Show or hide progress bar value.
+     * @defaultValue true
+     */
+    showValue?: boolean | undefined;
+    /**
+     * Unit sign appended to the value.
+     * @defaultValue %
+     */
+    unit?: string | undefined;
+    /**
+     * Defines the mode of the progress, valid values are "determinate" and "indeterminate".
+     * @defaultValue determinate
+     */
+    mode?: 'determinate' | 'indeterminate' | undefined;
+    /**
+     * Color for the background of the progress.
+     */
+    color?: string | undefined;
+    /**
+     * Custom display value template
+     */
+    displayValueTemplate?(value: string | number | undefined | null | undefined): React.ReactNode;
+    /**
+     * Used to get the child elements of the component.
+     * @readonly
+     */
+    children?: React.ReactNode | undefined;
 }
 
+/**
+ * **PrimeReact - ProgressBar**
+ *
+ * _ProgressBar is a process status indicator._
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/progressbar/)
+ * --- ---
+ * ![PrimeReact](https://www.primefaces.org/primereact/images/logo-100.png)
+ *
+ * @group Component
+ */
 export declare class ProgressBar extends React.Component<ProgressBarProps, any> {
+    /**
+     * Used to get container element.
+     * @return {HTMLDivElement} Container element
+     */
     public getElement(): HTMLDivElement;
 }

package/progressspinner/progressspinner.d.ts

@@ -1,12 +1,55 @@
+/**
+ *
+ * ProgressSpinner is a process status indicator.
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/progressspinner)
+ *
+ * @module progressspinner
+ *
+ */
 import * as React from 'react';
 
+/**
+ * Defines valid properties in ProgressSpinner component. In addition to these, all properties of HTMLDivElement can be used in this component.
+ * @group Properties
+ */
 export interface ProgressSpinnerProps extends Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, 'ref'> {
-    strokeWidth?: string;
-    fill?: string;
-    animationDuration?: string;
-    children?: React.ReactNode;
+    /**
+     * Width of the circle stroke.
+     * @defaultValue 2
+     */
+    strokeWidth?: string | undefined;
+    /**
+     * 	Color for the background of the circle.
+     */
+    fill?: string | undefined;
+    /**
+     * Duration of the rotate animation.
+     * @defaultValue 2s
+     */
+    animationDuration?: string | undefined;
+    /**
+     * Used to get the child elements of the component.
+     * @readonly
+     */
+    children?: React.ReactNode | undefined;
 }
 
+/**
+ * **PrimeReact - ProgressSpinner**
+ *
+ * _ProgressSpinner is a process status indicator._
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/progressspinner/)
+ * --- ---
+ * ![PrimeReact](https://www.primefaces.org/primereact/images/logo-100.png)
+ *
+ * @group Component
+ */
 export declare class ProgressSpinner extends React.Component<ProgressSpinnerProps, any> {
+    /**
+     * Used to get container element.
+     * @return {HTMLDivElement} Container element
+     */
     public getElement(): HTMLDivElement;
 }

package/radiobutton/radiobutton.cjs.js

@@ -148,7 +148,8 @@ var RadioButton = /*#__PURE__*/React__namespace.memo( /*#__PURE__*/React__namesp
     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);
     }
   };
@@ -164,6 +165,9 @@ var RadioButton = /*#__PURE__*/React__namespace.memo( /*#__PURE__*/React__namesp
     return {
       props: props,
       select: select,
+      focus: function focus() {
+        return utils.DomHandler.focus(inputRef.current);
+      },
       getElement: function getElement() {
         return elementRef.current;
       },

package/radiobutton/radiobutton.cjs.min.js

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

package/radiobutton/radiobutton.d.ts

@@ -1,39 +1,109 @@
+/**
+ *
+ * RadioButton is an extension to standard radio button element with theming.
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/radiobutton/)
+ *
+ * @module radiobutton
+ *
+ */
 import * as React from 'react';
-import TooltipOptions from '../tooltip/tooltipoptions';
+import { TooltipOptions } from '../tooltip/tooltipoptions';
+import { FormEvent } from '../ts-helpers';
 
-interface RadioButtonChangeTargetOptions {
-    type: string;
-    name: string;
-    id: string;
-    value: any;
-    checked: boolean;
-}
-
-interface RadioButtonChangeParams {
-    originalEvent: React.SyntheticEvent;
-    value: any;
-    checked: boolean;
-    stopPropagation(): void;
-    preventDefault(): void;
-    target: RadioButtonChangeTargetOptions;
-}
+/**
+ * Custom change event.
+ * @see {@link RadioButtonProps.onChange}
+ * @extends {FormEvent}
+ * @event
+ */
+interface RadioButtonChangeEvent extends FormEvent {}
 
+/**
+ * Defines valid properties in RadioButton component. In addition to these, all properties of HTMLDivElement can be used in this component.
+ * @group Properties
+ */
 export interface RadioButtonProps extends Omit<React.DetailedHTMLProps<React.InputHTMLAttributes<HTMLDivElement>, HTMLDivElement>, 'onChange' | 'ref'> {
-    inputRef?: React.Ref<HTMLInputElement>;
-    inputId?: string;
-    name?: string;
-    value?: any;
-    checked?: boolean;
-    disabled?: boolean;
-    required?: boolean;
-    tooltip?: string;
-    tooltipOptions?: TooltipOptions;
-    onChange?(e: RadioButtonChangeParams): void;
-    children?: React.ReactNode;
+    /**
+     * Reference of the input element.
+     */
+    inputRef?: React.Ref<HTMLInputElement> | undefined;
+    /**
+     * Unique identifier of the inner native radiobutton.
+     */
+    inputId?: string | undefined;
+    /**
+     * Name of the checkbox element.
+     */
+    name?: string | undefined;
+    /**
+     * Value of the checkbox.
+     */
+    value?: any | undefined;
+    /**
+     * Specifies whether a checkbox should be checked or not.
+     * @defaultValue false
+     */
+    checked?: boolean | 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;
+    /**
+     * Content of the tooltip.
+     */
+    tooltip?: string | undefined;
+    /**
+     * Configuration of the tooltip, refer to the tooltip documentation for more information.
+     */
+    tooltipOptions?: TooltipOptions | undefined;
+    /**
+     * Callback to invoke on value change
+     * @param {RadioButtonChangeEvent} event - Custom change event.
+     */
+    onChange?(event: RadioButtonChangeEvent): void;
+    /**
+     * Used to get the child elements of the component.
+     * @readonly
+     */
+    children?: React.ReactNode | undefined;
 }
 
+/**
+ * **PrimeReact - RadioButton**
+ *
+ * _RadioButton is an extension to standard radio button element with theming._
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/radiobutton/)
+ * --- ---
+ * ![PrimeReact](https://www.primefaces.org/primereact/images/logo-100.png)
+ *
+ * @group Component
+ */
 export declare class RadioButton extends React.Component<RadioButtonProps, any> {
-    public select(e?: React.SyntheticEvent): void;
+    /**
+     * Used to focus the component.
+     */
+    public focus(): void;
+    /**
+     * Used to select a button
+     * @param {React.SyntheticEvent} event - Browser event
+     */
+    public select(event?: React.SyntheticEvent): 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;
 }

package/radiobutton/radiobutton.esm.js

@@ -124,7 +124,8 @@ var RadioButton = /*#__PURE__*/React.memo( /*#__PURE__*/React.forwardRef(functio
     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);
     }
   };
@@ -140,6 +141,9 @@ var RadioButton = /*#__PURE__*/React.memo( /*#__PURE__*/React.forwardRef(functio
     return {
       props: props,
       select: select,
+      focus: function focus() {
+        return DomHandler.focus(inputRef.current);
+      },
       getElement: function getElement() {
         return elementRef.current;
       },

package/radiobutton/radiobutton.esm.min.js

@@ -1 +1 @@
-import*as e from"react";import{Tooltip as t}from"primereact/tooltip";import{ObjectUtils as n,DomHandler as r,classNames as a}from"primereact/utils";function o(){return o=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},o.apply(this,arguments)}function i(e){if(Array.isArray(e))return e}function l(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var r,a,o,i,l=[],u=!0,c=!1;try{if(o=(n=n.call(e)).next,0===t){if(Object(n)!==n)return;u=!1}else for(;!(u=(r=o.call(n)).done)&&(l.push(r.value),l.length!==t);u=!0);}catch(e){c=!0,a=e}finally{try{if(!u&&null!=n.return&&(i=n.return(),Object(i)!==i))return}finally{if(c)throw a}}return l}}function u(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 c(e,t){if(e){if("string"==typeof e)return u(e,t);var n=Object.prototype.toString.call(e).slice(8,-1);return"Object"===n&&e.constructor&&(n=e.constructor.name),"Map"===n||"Set"===n?Array.from(e):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?u(e,t):void 0}}function 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 s=e.memo(e.forwardRef((function(u,f){var p,m,b=e.useState(!1),h=(m=2,i(p=b)||l(p,m)||c(p,m)||d()),v=h[0],y=h[1],g=e.useRef(null),k=e.useRef(u.inputRef),E=function(e){R(e)},R=function(e){if(!u.disabled&&u.onChange){var t=u.checked,n=e.target instanceof HTMLDivElement,a=e.target===k.current&&e.target.checked!==t,o=n&&r.hasClass(g.current,"p-radiobutton-checked")===t&&!t;if(a||o){var i=!t;u.onChange({originalEvent:e,value:u.value,checked:i,stopPropagation:function(){},preventDefault:function(){},target:{type:"radio",name:u.name,id:u.id,value:u.value,checked:i}}),o&&(k.current.checked=i)}r.focus(k.current),e.preventDefault()}};e.useEffect((function(){k.current&&(k.current.checked=u.checked)}),[u.checked]),e.useEffect((function(){n.combinedRefs(k,u.inputRef)}),[k,u.inputRef]),e.useImperativeHandle(f,(function(){return{props:u,select:E,getElement:function(){return g.current},getInput:function(){return k.current}}}));var I=n.isNotEmpty(u.tooltip),O=n.findDiffKeys(u,s.defaultProps),j=n.reduceKeys(O,r.ARIA_PROPS),A=a("p-radiobutton p-component",{"p-radiobutton-checked":u.checked,"p-radiobutton-disabled":u.disabled,"p-radiobutton-focused":v},u.className),N=a("p-radiobutton-box",{"p-highlight":u.checked,"p-disabled":u.disabled,"p-focus":v});return e.createElement(e.Fragment,null,e.createElement("div",o({ref:g,id:u.id,className:A,style:u.style},O,{onClick:R}),e.createElement("div",{className:"p-hidden-accessible"},e.createElement("input",o({ref:k,id:u.inputId,type:"radio",name:u.name,defaultChecked:u.checked,onFocus:function(){y(!0)},onBlur:function(){y(!1)},onKeyDown:function(e){"Space"===e.code&&R(e)},disabled:u.disabled,required:u.required,tabIndex:u.tabIndex},j))),e.createElement("div",{className:N},e.createElement("div",{className:"p-radiobutton-icon"}))),I&&e.createElement(t,o({target:g,content:u.tooltip},u.tooltipOptions)))})));s.displayName="RadioButton",s.defaultProps={__TYPE:"RadioButton",id:null,inputRef:null,inputId:null,name:null,value:null,checked:!1,style:null,className:null,disabled:!1,required:!1,tabIndex:null,tooltip:null,tooltipOptions:null,onChange:null};export{s as RadioButton};
+import*as e from"react";import{Tooltip as t}from"primereact/tooltip";import{ObjectUtils as n,DomHandler as r,classNames as o}from"primereact/utils";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 i(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,i,u=[],c=!0,l=!1;try{if(a=(n=n.call(e)).next,0===t){if(Object(n)!==n)return;c=!1}else for(;!(c=(r=a.call(n)).done)&&(u.push(r.value),u.length!==t);c=!0);}catch(e){l=!0,o=e}finally{try{if(!c&&null!=n.return&&(i=n.return(),Object(i)!==i))return}finally{if(l)throw o}}return u}}function c(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 l(e,t){if(e){if("string"==typeof e)return c(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)?c(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 s=e.memo(e.forwardRef((function(c,f){var p,m,b=e.useState(!1),h=(m=2,i(p=b)||u(p,m)||l(p,m)||d()),y=h[0],v=h[1],g=e.useRef(null),k=e.useRef(c.inputRef),E=function(e){R(e)},R=function(e){if(!c.disabled&&c.onChange){var t=c.checked,n=e.target instanceof HTMLDivElement,o=e.target===k.current&&e.target.checked!==t,a=n&&r.hasClass(g.current,"p-radiobutton-checked")===t&&!t;if(o||a){var i=!t;c.onChange({originalEvent:e,value:c.value,checked:i,stopPropagation:function(){},preventDefault:function(){},target:{type:"radio",name:c.name,id:c.id,value:c.value,checked:i}}),a&&(k.current.checked=i)}r.focus(k.current),e.preventDefault()}};e.useEffect((function(){k.current&&(k.current.checked=c.checked)}),[c.checked]),e.useEffect((function(){n.combinedRefs(k,c.inputRef)}),[k,c.inputRef]),e.useImperativeHandle(f,(function(){return{props:c,select:E,focus:function(){return r.focus(k.current)},getElement:function(){return g.current},getInput:function(){return k.current}}}));var I=n.isNotEmpty(c.tooltip),O=n.findDiffKeys(c,s.defaultProps),j=n.reduceKeys(O,r.ARIA_PROPS),A=o("p-radiobutton p-component",{"p-radiobutton-checked":c.checked,"p-radiobutton-disabled":c.disabled,"p-radiobutton-focused":y},c.className),N=o("p-radiobutton-box",{"p-highlight":c.checked,"p-disabled":c.disabled,"p-focus":y});return e.createElement(e.Fragment,null,e.createElement("div",a({ref:g,id:c.id,className:A,style:c.style},O,{onClick:R}),e.createElement("div",{className:"p-hidden-accessible"},e.createElement("input",a({ref:k,id:c.inputId,type:"radio",name:c.name,defaultChecked:c.checked,onFocus:function(){v(!0)},onBlur:function(){v(!1)},onKeyDown:function(e){"Space"!==e.code&&" "!==e.key||R(e)},disabled:c.disabled,required:c.required,tabIndex:c.tabIndex},j))),e.createElement("div",{className:N},e.createElement("div",{className:"p-radiobutton-icon"}))),I&&e.createElement(t,a({target:g,content:c.tooltip},c.tooltipOptions)))})));s.displayName="RadioButton",s.defaultProps={__TYPE:"RadioButton",id:null,inputRef:null,inputId:null,name:null,value:null,checked:!1,style:null,className:null,disabled:!1,required:!1,tabIndex:null,tooltip:null,tooltipOptions:null,onChange:null};export{s as RadioButton};

package/radiobutton/radiobutton.js

@@ -144,7 +144,8 @@ this.primereact.radiobutton = (function (exports, React, tooltip, utils) {
       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);
       }
     };
@@ -160,6 +161,9 @@ this.primereact.radiobutton = (function (exports, React, tooltip, utils) {
       return {
         props: props,
         select: select,
+        focus: function focus() {
+          return utils.DomHandler.focus(inputRef.current);
+        },
         getElement: function getElement() {
           return elementRef.current;
         },

package/radiobutton/radiobutton.min.js

@@ -1 +1 @@
-this.primereact=this.primereact||{},this.primereact.radiobutton=function(e,t,n,r){"use strict";function a(e){if(e&&e.__esModule)return e;var t=Object.create(null);return e&&Object.keys(e).forEach((function(n){if("default"!==n){var 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 i=a(t);function o(){return o=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},o.apply(this,arguments)}function c(e){if(Array.isArray(e))return e}function l(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var r,a,i,o,c=[],l=!0,u=!1;try{if(i=(n=n.call(e)).next,0===t){if(Object(n)!==n)return;l=!1}else for(;!(l=(r=i.call(n)).done)&&(c.push(r.value),c.length!==t);l=!0);}catch(e){u=!0,a=e}finally{try{if(!l&&null!=n.return&&(o=n.return(),Object(o)!==o))return}finally{if(u)throw a}}return c}}function u(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 d(e,t){if(e){if("string"==typeof e)return u(e,t);var n=Object.prototype.toString.call(e).slice(8,-1);return"Object"===n&&e.constructor&&(n=e.constructor.name),"Map"===n||"Set"===n?Array.from(e):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?u(e,t):void 0}}function s(){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=i.memo(i.forwardRef((function(e,t){var a,u,p=i.useState(!1),m=(u=2,c(a=p)||l(a,u)||d(a,u)||s()),b=m[0],h=m[1],v=i.useRef(null),y=i.useRef(e.inputRef),g=function(e){O(e)},O=function(t){if(!e.disabled&&e.onChange){var n=e.checked,a=t.target instanceof HTMLDivElement,i=t.target===y.current&&t.target.checked!==n,o=a&&r.DomHandler.hasClass(v.current,"p-radiobutton-checked")===n&&!n;if(i||o){var c=!n;e.onChange({originalEvent:t,value:e.value,checked:c,stopPropagation:function(){},preventDefault:function(){},target:{type:"radio",name:e.name,id:e.id,value:e.value,checked:c}}),o&&(y.current.checked=c)}r.DomHandler.focus(y.current),t.preventDefault()}};i.useEffect((function(){y.current&&(y.current.checked=e.checked)}),[e.checked]),i.useEffect((function(){r.ObjectUtils.combinedRefs(y,e.inputRef)}),[y,e.inputRef]),i.useImperativeHandle(t,(function(){return{props:e,select:g,getElement:function(){return v.current},getInput:function(){return y.current}}}));var j=r.ObjectUtils.isNotEmpty(e.tooltip),k=r.ObjectUtils.findDiffKeys(e,f.defaultProps),E=r.ObjectUtils.reduceKeys(k,r.DomHandler.ARIA_PROPS),R=r.classNames("p-radiobutton p-component",{"p-radiobutton-checked":e.checked,"p-radiobutton-disabled":e.disabled,"p-radiobutton-focused":b},e.className),I=r.classNames("p-radiobutton-box",{"p-highlight":e.checked,"p-disabled":e.disabled,"p-focus":b});return i.createElement(i.Fragment,null,i.createElement("div",o({ref:v,id:e.id,className:R,style:e.style},k,{onClick:O}),i.createElement("div",{className:"p-hidden-accessible"},i.createElement("input",o({ref:y,id:e.inputId,type:"radio",name:e.name,defaultChecked:e.checked,onFocus:function(){h(!0)},onBlur:function(){h(!1)},onKeyDown:function(e){"Space"===e.code&&O(e)},disabled:e.disabled,required:e.required,tabIndex:e.tabIndex},E))),i.createElement("div",{className:I},i.createElement("div",{className:"p-radiobutton-icon"}))),j&&i.createElement(n.Tooltip,o({target:v,content:e.tooltip},e.tooltipOptions)))})));return f.displayName="RadioButton",f.defaultProps={__TYPE:"RadioButton",id:null,inputRef:null,inputId:null,name:null,value:null,checked:!1,style:null,className:null,disabled:!1,required:!1,tabIndex:null,tooltip:null,tooltipOptions:null,onChange:null},e.RadioButton=f,Object.defineProperty(e,"__esModule",{value:!0}),e}({},React,primereact.tooltip,primereact.utils);
+this.primereact=this.primereact||{},this.primereact.radiobutton=function(e,t,n,r){"use strict";function a(e){if(e&&e.__esModule)return e;var t=Object.create(null);return e&&Object.keys(e).forEach((function(n){if("default"!==n){var 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 o=a(t);function i(){return i=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e},i.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,a,o,i,c=[],u=!0,l=!1;try{if(o=(n=n.call(e)).next,0===t){if(Object(n)!==n)return;u=!1}else for(;!(u=(r=o.call(n)).done)&&(c.push(r.value),c.length!==t);u=!0);}catch(e){l=!0,a=e}finally{try{if(!u&&null!=n.return&&(i=n.return(),Object(i)!==i))return}finally{if(l)throw a}}return c}}function l(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 d(e,t){if(e){if("string"==typeof e)return l(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)?l(e,t):void 0}}function s(){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=o.memo(o.forwardRef((function(e,t){var a,l,p=o.useState(!1),m=(l=2,c(a=p)||u(a,l)||d(a,l)||s()),b=m[0],h=m[1],y=o.useRef(null),v=o.useRef(e.inputRef),g=function(e){O(e)},O=function(t){if(!e.disabled&&e.onChange){var n=e.checked,a=t.target instanceof HTMLDivElement,o=t.target===v.current&&t.target.checked!==n,i=a&&r.DomHandler.hasClass(y.current,"p-radiobutton-checked")===n&&!n;if(o||i){var c=!n;e.onChange({originalEvent:t,value:e.value,checked:c,stopPropagation:function(){},preventDefault:function(){},target:{type:"radio",name:e.name,id:e.id,value:e.value,checked:c}}),i&&(v.current.checked=c)}r.DomHandler.focus(v.current),t.preventDefault()}};o.useEffect((function(){v.current&&(v.current.checked=e.checked)}),[e.checked]),o.useEffect((function(){r.ObjectUtils.combinedRefs(v,e.inputRef)}),[v,e.inputRef]),o.useImperativeHandle(t,(function(){return{props:e,select:g,focus:function(){return r.DomHandler.focus(v.current)},getElement:function(){return y.current},getInput:function(){return v.current}}}));var j=r.ObjectUtils.isNotEmpty(e.tooltip),k=r.ObjectUtils.findDiffKeys(e,f.defaultProps),E=r.ObjectUtils.reduceKeys(k,r.DomHandler.ARIA_PROPS),R=r.classNames("p-radiobutton p-component",{"p-radiobutton-checked":e.checked,"p-radiobutton-disabled":e.disabled,"p-radiobutton-focused":b},e.className),I=r.classNames("p-radiobutton-box",{"p-highlight":e.checked,"p-disabled":e.disabled,"p-focus":b});return o.createElement(o.Fragment,null,o.createElement("div",i({ref:y,id:e.id,className:R,style:e.style},k,{onClick:O}),o.createElement("div",{className:"p-hidden-accessible"},o.createElement("input",i({ref:v,id:e.inputId,type:"radio",name:e.name,defaultChecked:e.checked,onFocus:function(){h(!0)},onBlur:function(){h(!1)},onKeyDown:function(e){"Space"!==e.code&&" "!==e.key||O(e)},disabled:e.disabled,required:e.required,tabIndex:e.tabIndex},E))),o.createElement("div",{className:I},o.createElement("div",{className:"p-radiobutton-icon"}))),j&&o.createElement(n.Tooltip,i({target:y,content:e.tooltip},e.tooltipOptions)))})));return f.displayName="RadioButton",f.defaultProps={__TYPE:"RadioButton",id:null,inputRef:null,inputId:null,name:null,value:null,checked:!1,style:null,className:null,disabled:!1,required:!1,tabIndex:null,tooltip:null,tooltipOptions:null,onChange:null},e.RadioButton=f,Object.defineProperty(e,"__esModule",{value:!0}),e}({},React,primereact.tooltip,primereact.utils);

package/rating/rating.d.ts

@@ -1,39 +1,116 @@
+/**
+ *
+ * Rating component is a star based selection input.
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/rating/)
+ *
+ * @module rating
+ *
+ */
 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 RatingChangeTargetOptions {
-    name: string;
-    id: string;
-    value: number | undefined | null;
-}
-
-interface RatingChangeParams {
-    originalEvent: React.SyntheticEvent;
-    value: number | undefined | null;
-    stopPropagation(): void;
-    preventDefault(): void;
-    target: RatingChangeTargetOptions;
-}
+/**
+ * Custom change event.
+ * @see {@link RatingProps.onChange}
+ * @extends {FormEvent}
+ * @event
+ */
+interface RatingChangeEvent extends FormEvent<number> {}
 
+/**
+ * Defines valid properties in Rating component. In addition to these, all properties of HTMLDivElement can be used in this component.
+ * @group Properties
+ */
 export interface RatingProps extends Omit<React.DetailedHTMLProps<React.InputHTMLAttributes<HTMLDivElement>, HTMLDivElement>, 'onChange' | 'ref'> {
-    value?: number;
-    disabled?: boolean;
-    readOnly?: boolean;
-    stars?: number;
-    cancel?: boolean;
-    tooltip?: string;
-    tooltipOptions?: TooltipOptions;
-    onChange?(e: RatingChangeParams): void;
-    children?: React.ReactNode;
-    onIcon?: IconType<RatingProps>;
+    /**
+     * Value of the rating.
+     */
+    value?: number | undefined;
+    /**
+     * When present, it specifies that the element should be disabled.
+     * @defaultValue false
+     */
+    disabled?: boolean | undefined;
+    /**
+     * When present, it specifies that the input cannot be typed.
+     * @defaultValue false
+     */
+    readOnly?: boolean | undefined;
+    /**
+     * Number of stars.
+     * @defaultValue 5
+     */
+    stars?: number | undefined;
+    /**
+     * When specified a cancel icon is displayed to allow removing the value.
+     * @defaultValue true
+     */
+    cancel?: boolean | undefined;
+    /**
+     * Content of the tooltip.
+     */
+    tooltip?: string | undefined;
+    /**
+     * Configuration of the tooltip, refer to the tooltip documentation for more information.
+     */
+    tooltipOptions?: TooltipOptions | undefined;
+    /**
+     * Callback to invoke on value change.
+     * @param {RatingChangeEvent} event - Custom change event.
+     */
+    onChange?(event: RatingChangeEvent): void;
+    /**
+     * Used to get the child elements of the component.
+     * @readonly
+     */
+    children?: React.ReactNode | undefined;
+    /**
+     * ClassName of the on icon component.
+     * @defaultValue pi pi-star-fill
+     */
+    onIcon?: IconType<RatingProps> | undefined;
+    /**
+     * ClassName of the off icon component.
+     * @defaultValue pi pi-star
+     */
     offIcon?: IconType<RatingProps>;
+    /**
+     * ClassName of the cancel icon component.
+     * @defaultValue pi pi-ban
+     */
     cancelIcon?: IconType<RatingProps>;
+    /**
+     * Properties of the cancel icon.
+     */
     cancelIconProps?: React.HTMLAttributes<HTMLSpanElement>;
+    /**
+     * Properties of the on icon.
+     */
     onIconProps?: React.HTMLAttributes<HTMLSpanElement>;
+    /**
+     * Properties of the off icon.
+     */
     offIconProps?: React.HTMLAttributes<HTMLSpanElement>;
 }
 
+/**
+ * **PrimeReact - Rating**
+ *
+ * _Rating component is a star based selection input._
+ *
+ * [Live Demo](https://www.primefaces.org/primereact/rating/)
+ * --- ---
+ * ![PrimeReact](https://www.primefaces.org/primereact/images/logo-100.png)
+ *
+ * @group Component
+ */
 export declare class Rating extends React.Component<RatingProps, any> {
+    /**
+     * Used to get container element.
+     * @return {HTMLDivElement} Container element
+     */
     public getElement(): HTMLDivElement;
 }