@applica-software-guru/react-admin 1.3.184 → 1.4.0-beta.0

package/src/components/ra-forms/SimpleForm.tsx

@@ -11,16 +11,13 @@ import ActionsMenu from '../ActionsMenu';
 import MainCard from '../MainCard';
 import Toolbar from './Toolbar';
 
-const ApplicaStyledSimpleForm = styled(RaSimpleForm, {
-  name: 'RaApplicaSimpleForm',
-  slot: 'Root'
-})(({ theme, modal }: { theme: any; modal: boolean }) => ({
+const StyledSimpleForm = styled(RaSimpleForm, { slot: 'Root' })(({ theme, modal }: { theme: any; modal: boolean }) => ({
   '& .MuiGrid-root.MuiGrid-container': {
     paddingBottom: theme.spacing(modal ? 0 : 2.5)
   } as any,
-  [theme.breakpoints.down('sm')]: {
-    paddingBottom: 0
-  }
+  // [theme.breakpoints.down('sm')]: {
+  paddingBottom: '0 !important',
+  // }
 }));
 
 export type SimpleFormProps = RaSimpleFormProps & {
@@ -71,7 +68,7 @@ export function SimpleForm({
       divider
     >
       {/* @ts-ignore */}
-      <ApplicaStyledSimpleForm toolbar={toolbar} {...props} />
+      <StyledSimpleForm toolbar={toolbar} {...props} />
     </MainCard>
   );
 }

package/src/components/ra-forms/SimpleFormIterator.tsx

@@ -1,32 +1,30 @@
 import { SimpleFormIterator as RaSimpleFormIterator } from 'react-admin';
 import { styled } from '@mui/material/styles';
 
-export function SimpleFormIterator(): JSX.Element {
-  // @ts-ignore
-  return styled(RaSimpleFormIterator, {
-    name: 'ApplicaSimpleFormIterator',
-    root: 'root'
-  })(({ theme }) => ({
-    '& .RaSimpleFormIterator-line': {
-      paddingTop: theme.spacing(1),
-      paddingBottom: theme.spacing(0.5)
-    },
-    '& .RaSimpleFormIterator-action': {
-      display: 'flex',
-      flexDirection: 'row',
-      alignItems: 'center',
-      mb: 1.5
-    },
-    '& section': {
-      width: '100%',
-      '& label': {
-        position: 'relative',
-        overflow: 'visible',
-        transform: 'none',
-        marginLeft: 0
-      }
+// @ts-ignore
+const StyledSimpleFormIterator = styled(RaSimpleFormIterator, { root: 'root' })(({ theme }) => ({
+  '& .RaSimpleFormIterator-line': {
+    paddingTop: theme.spacing(1),
+    paddingBottom: theme.spacing(0.5)
+  },
+  '& .RaSimpleFormIterator-action': {
+    display: 'flex',
+    flexDirection: 'row',
+    alignItems: 'center',
+    mb: 1.5
+  },
+  '& section': {
+    width: '100%',
+    '& label': {
+      position: 'relative',
+      overflow: 'visible',
+      transform: 'none',
+      marginLeft: 0
     }
-  }));
-}
+  }
+}));
 
+export function SimpleFormIterator(props: any): JSX.Element {
+  return <StyledSimpleFormIterator {...props} />;
+}
 export default SimpleFormIterator;

package/src/components/ra-forms/TabbedForm.tsx

@@ -25,10 +25,7 @@ export type TabbedFormProps = RaTabbedFormProps & {
   noPadding?: boolean;
 };
 
-const StyledTabbedForm = styled(RaTabbedForm, {
-  name: 'RaApplicaTabbedForm',
-  slot: 'Root'
-})(({ theme, modal }: { theme: any; modal: boolean }) => ({
+const StyledTabbedForm = styled(RaTabbedForm, { slot: 'Root' })(({ theme, modal }: { theme: any; modal: boolean }) => ({
   '& .MuiGrid-root.MuiGrid-container': {
     paddingBottom: theme.spacing(modal ? 0 : 1)
   } as any,
@@ -83,7 +80,10 @@ export function TabbedForm(props: TabbedFormProps): JSX.Element {
           ml: 2.5,
           mr: 2.5
         },
-
+        '& .MuiToolbar-root.RaToolbar-desktopToolbar': {
+          position: 'initial',
+          paddingTop: 0
+        },
         '& .MuiToolbar-root': {
           padding: 2.5
         }

package/src/components/ra-forms/TableForm/TableFormIterator.tsx

@@ -38,9 +38,6 @@ import get from 'lodash/get';
  *       </ArrayInput>
  *     </Grid>
  *   </Grid>
- *
- * @param props
- * @returns
  */
 export function RawTableFormIterator(props: TableFormIteratorProps): ReactElement | null {
   const {
@@ -164,8 +161,8 @@ export function RawTableFormIterator(props: TableFormIteratorProps): ReactElemen
           sx={
             inset === true
               ? {
-                  borderRadius: 0
-                }
+                borderRadius: 0
+              }
               : { mt: 2, border: `1px solid ${tableBorderColor}` }
           }
         >
@@ -277,14 +274,12 @@ function AddTableRow(props: any): JSX.Element {
   );
 }
 
-export const TableFormIterator = styled(RawTableFormIterator, {
-  name: 'RaApplicaTableFormIterator',
-  slot: 'Root'
-})(({ theme }) => ({
+export const TableFormIterator = styled(RawTableFormIterator, { slot: 'Root' })(({ theme }) => ({
   '& > div.MuiPaper-root': {
     overflowX: 'auto',
+    // this decision has been made with Roberto in order to avoid Marco gets angry
     [theme.breakpoints.down('sm')]: {
-      width: `calc(100vw - ${theme.spacing(8)})`
+      width: `calc(100vw - ${theme.spacing(8.25)})`
     }
   },
   [theme.breakpoints.down('sm')]: {

package/src/components/ra-forms/Toolbar.tsx

@@ -1,10 +1,7 @@
 import { styled } from '@mui/system';
 import { Toolbar as RaToolbar, ToolbarProps } from 'react-admin';
 
-const StyledToolbar = styled(RaToolbar, {
-  name: 'RaApplicaToolbar',
-  slot: 'Root'
-})(({ theme }: { theme: any }) => ({
+const StyledToolbar = styled(RaToolbar, { slot: 'Root' })(({ theme }: { theme: any }) => ({
   ...theme.mixins.toolbar,
   backgroundColor: theme.palette.background.paper,
   justifyContent: 'flex-end',

package/src/components/ra-forms/index.ts

@@ -10,3 +10,4 @@ export * from './SimpleFormIterator';
 export * from './TabbedForm';
 export * from './TableForm';
 export * from './Toolbar';
+export { default as LongForm } from './LongForm';

package/src/components/ra-inputs/ArrayInput.tsx

@@ -2,10 +2,7 @@ import { ArrayInput as RaArrayInput, ArrayInputProps as RaArrayInputProps } from
 import { styled } from '@mui/material/styles';
 import LabeledArrayInput, { LabeledArrayInputProps } from './LabeledArrayInput';
 
-const StyledArrayInput = styled(RaArrayInput, {
-  name: 'ApplicaArrayInput',
-  slot: 'root'
-})(({ theme }) => ({
+const StyledArrayInput = styled(RaArrayInput, { slot: 'root' })(({ theme }) => ({
   '& .MuiStack-root > label': {
     marginTop: theme.spacing(2)
   },
@@ -27,11 +24,8 @@ export type ArrayInputProps = RaArrayInputProps &
   };
 
 /**
- * Espone un componente di tipo ArrayInput con stile grafico di Applica.
- * Se vuoi utilizzare il componente puro di react-admin puoi usare RaArrayInput esposto nella libreria.
- *
- * @param {ArrayInputProps}
- * @returns {React.ReactElement}
+ * Expose an ArrayInput component with Applica graphic style.
+ * If you want to use the pure react-admin component you can use RaArrayInput exposed in the library.
  */
 export function ArrayInput({ label, addLabel, source, helperText, divider = true, ...props }: ArrayInputProps): React.ReactElement {
   return (

package/src/components/ra-inputs/AttachmentInput.tsx

@@ -20,10 +20,7 @@ const removeDeleteIfNecessary = (disabled: boolean) => {
   return {};
 };
 
-const StyledFileInput = styled(RaFileInput, {
-  name: 'RaApplicaFileInput',
-  slot: 'root'
-})(({ disabled, theme }: { disabled: boolean; theme: any }) => ({
+const StyledFileInput = styled(RaFileInput, { slot: 'root' })(({ disabled, theme }: { disabled: boolean; theme: any }) => ({
   '& .previews': {},
   '& .previews>div': {
     marginTop: theme.spacing(1),
@@ -57,9 +54,6 @@ export type AttachmentInputProps = FileInputProps & {
  *
  * @example
  * <AttachmentInput source="attachments" title="name" accept="image/*" multiple>
- *
- * @param {AttachmentInputProps}
- * @returns
  */
 export function AttachmentInput({
   // @ts-ignore

package/src/components/ra-inputs/BooleanInput.tsx

@@ -3,10 +3,7 @@ import { styled } from '@mui/material/styles';
 import { useTheme } from '@emotion/react';
 import LabeledInput from './LabeledInput';
 
-const StyledBooleanInput = styled(RaBooleanInput, {
-  name: 'RaApplicaBooleanInput',
-  slot: 'Root'
-})(() => ({
+const StyledBooleanInput = styled(RaBooleanInput, { slot: 'Root' })(() => ({
   marginTop: '0 !important'
 }));
 

package/src/components/ra-inputs/DateInput.tsx

@@ -2,10 +2,7 @@ import { DateInputProps, DateInput as RaDateInput } from 'react-admin';
 import { styled } from '@mui/material/styles';
 import LabeledInput from './LabeledInput';
 
-const StyledDateInput = styled(RaDateInput, {
-  name: 'RaApplicaDateInput',
-  slot: 'root'
-})(({ label }) => ({
+const StyledDateInput = styled(RaDateInput, { slot: 'root' })(({ label }) => ({
   '& legend': {
     width: label === false ? 0 : 'auto'
   }

package/src/components/ra-inputs/DateTimeInput.tsx

@@ -2,10 +2,7 @@ import { DateTimeInputProps, DateTimeInput as RaDateTimeInput } from 'react-admi
 import { styled } from '@mui/material/styles';
 import LabeledInput from './LabeledInput';
 
-const StyledDateInput = styled(RaDateTimeInput, {
-  name: 'RaApplicaDateTimeInput',
-  slot: 'root'
-})(({ label }) => ({
+const StyledDateInput = styled(RaDateTimeInput, { slot: 'root' })(({ label }) => ({
   '& legend': {
     width: label === false ? 0 : 'auto'
   }

package/src/components/ra-inputs/FileInput.tsx

@@ -6,10 +6,7 @@ import { useWatch } from 'react-hook-form';
 import LabeledInput from './LabeledInput';
 import React, { useMemo } from 'react';
 
-const StyledFileInput = styled(RaFileInput, {
-  name: 'RaApplicaFileInput',
-  slot: 'root'
-})(({ theme }) => ({
+const StyledFileInput = styled(RaFileInput, { slot: 'root' })(({ theme }) => ({
   '& .previews': {},
   '& .previews>div': {
     marginTop: theme.spacing(1),

package/src/components/ra-inputs/NumberInput.tsx

@@ -2,10 +2,7 @@ import { NumberInputProps, NumberInput as RaNumberInput } from 'react-admin';
 import { styled } from '@mui/material/styles';
 import LabeledInput from './LabeledInput';
 
-const StyledNumberInput = styled(RaNumberInput, {
-  name: 'RaApplicaNumberInput',
-  slot: 'root'
-})(({ label }) => ({
+const StyledNumberInput = styled(RaNumberInput, { slot: 'root' })(({ label }) => ({
   '& legend': {
     width: label === false ? 0 : 'auto'
   }

package/src/components/ra-inputs/SearchInput.tsx

@@ -1,10 +1,7 @@
 import { SearchInput as RaSearchInput, SearchInputProps } from 'react-admin';
 import { styled } from '@mui/material/styles';
 
-const StyledSearchInput = styled(RaSearchInput, {
-  name: 'RaApplicaSearchInput',
-  slot: 'root'
-})(() => ({}));
+const StyledSearchInput = styled(RaSearchInput, { slot: 'root' })(() => ({}));
 
 export function SearchInput(props: SearchInputProps): JSX.Element {
   return <StyledSearchInput {...props} />;

package/src/components/ra-inputs/SelectArrayInput.tsx

@@ -2,10 +2,7 @@ import { SelectArrayInput as RaSelectArrayInput, SelectArrayInputProps } from 'r
 import { styled } from '@mui/material/styles';
 import LabeledInput from './LabeledInput';
 
-const StyledSelectArrayInput = styled(RaSelectArrayInput, {
-  name: 'RaApplicaSelectArrayInput',
-  slot: 'Root'
-})(({ label }) => ({
+const StyledSelectArrayInput = styled(RaSelectArrayInput, { slot: 'Root' })(({ label }) => ({
   '& legend': {
     width: label === false ? 0 : 'auto'
   },

package/src/components/ra-inputs/SelectInput.tsx

@@ -2,10 +2,7 @@ import { SelectInput as RaSelectInput, SelectInputProps as RaSelectInputProps }
 import { styled } from '@mui/material/styles';
 import LabeledInput, { LabeledInputProps } from './LabeledInput';
 
-const ApplicaStyledSelectInput = styled(RaSelectInput, {
-  name: 'RaApplicaSelectArrayInput',
-  slot: 'Root'
-})(({ label }) => ({
+const StyledSelectInput = styled(RaSelectInput, { slot: 'Root' })(({ label }) => ({
   '& legend': {
     width: label === false || label === null ? 0 : 'auto'
   }
@@ -14,7 +11,7 @@ export type SelectInputProps = LabeledInputProps & RaSelectInputProps;
 export function SelectInput(props: SelectInputProps): JSX.Element {
   return (
     <LabeledInput {...props}>
-      <ApplicaStyledSelectInput />
+      <StyledSelectInput />
     </LabeledInput>
   );
 }

package/src/components/ra-inputs/TimeInput.tsx

@@ -17,10 +17,7 @@ function defaultParser(v: string): string {
   return v;
 }
 
-const StyledTimeInput = styled(RaTimeInput, {
-  name: 'RaApplicaTimeInput',
-  slot: 'root'
-})(({ label }) => ({
+const StyledTimeInput = styled(RaTimeInput, { slot: 'root' })(({ label }) => ({
   '& legend': {
     width: label === false ? 0 : 'auto'
   }

package/src/components/ra-lists/Datagrid/Datagrid.tsx

@@ -17,41 +17,41 @@ import BulkActionsToolbar from '../BulkActionsToolbar';
 import clsx from 'clsx';
 import DatagridContextProvider from './DatagridContextProvider';
 import difference from 'lodash/difference';
-import PropTypes from 'prop-types';
 import union from 'lodash/union';
 
 const defaultBulkActionButtons = <BulkDeleteButton />;
 
-export type DatagridProps = RaDatagridProps & {
-  /**
-   * An alternative to bulkActionButtons, to be used when the actions are too complex to be expressed.
-   * In this case you are free to fully control the rendering of the bulk actions toolbar.
-   * @see BulkActionsToolbar
-   * @example <caption>Using the BulkActionsToolbar component</caption>
-   * import { BulkActionsToolbar } from '@applica-software-guru/react-admin';
-   * import { BulkDeleteButton } from 'react-admin';
-   *
-   * const PostBulkActionButtons = props => (
-   *    <BulkActionsToolbar {...props}>
-   *       <BulkDeleteButton />
-   *      // add your custom actions here
-   *   </BulkActionsToolbar>
-   * );
-   *
-   * @example <caption>Using BulkFloatingActionsToolbar component</caption>
-   * import { BulkActionsToolbar } from '@applica-software-guru/react-admin';
-   * import { BulkDeleteButton } from 'react-admin';
-   *
-   * const PostBulkActionButtons = props => (
-   *   <BulkActionsToolbar {...props}>
-   *      <BulkDeleteButton />
-   *     // add your custom actions here
-   *   </BulkActionsToolbar>
-   * );
-   *
-   */
-  bulkActionsToolbar: React.ReactNode | React.FC | boolean;
-};
+export type DatagridProps = RaDatagridProps &
+  React.RefAttributes<HTMLTableElement> & {
+    /**
+     * An alternative to bulkActionButtons, to be used when the actions are too complex to be expressed.
+     * In this case you are free to fully control the rendering of the bulk actions toolbar.
+     * @see BulkActionsToolbar
+     * @example <caption>Using the BulkActionsToolbar component</caption>
+     * import { BulkActionsToolbar } from '@applica-software-guru/react-admin';
+     * import { BulkDeleteButton } from 'react-admin';
+     *
+     * const PostBulkActionButtons = props => (
+     *    <BulkActionsToolbar {...props}>
+     *       <BulkDeleteButton />
+     *      // add your custom actions here
+     *   </BulkActionsToolbar>
+     * );
+     *
+     * @example <caption>Using BulkFloatingActionsToolbar component</caption>
+     * import { BulkActionsToolbar } from '@applica-software-guru/react-admin';
+     * import { BulkDeleteButton } from 'react-admin';
+     *
+     * const PostBulkActionButtons = props => (
+     *   <BulkActionsToolbar {...props}>
+     *      <BulkDeleteButton />
+     *     // add your custom actions here
+     *   </BulkActionsToolbar>
+     * );
+     *
+     */
+    bulkActionsToolbar: React.ReactNode | React.FC | boolean;
+  };
 
 /**
  * The Datagrid component renders a list of records as a table.
@@ -131,7 +131,7 @@ export type DatagridProps = RaDatagridProps & {
  *     );
  * }
  */
-export const Datagrid: FC<DatagridProps> = React.forwardRef((props, ref) => {
+export const Datagrid = React.forwardRef((props, ref) => {
   const {
     optimized = false,
     body = optimized ? PureDatagridBody : DatagridBody,
@@ -156,11 +156,8 @@ export const Datagrid: FC<DatagridProps> = React.forwardRef((props, ref) => {
   } = props;
 
   const { sort, data, isLoading, onSelect, onToggleItem, selectedIds, setSort, total } = useListContext(props);
-
   const hasBulkActions = !!bulkActionButtons !== false;
-
   const contextValue = useMemo(() => ({ isRowExpandable, expandSingle }), [isRowExpandable, expandSingle]);
-
   const lastSelected = useRef(null);
 
   useEffect(() => {
@@ -278,47 +275,12 @@ export const Datagrid: FC<DatagridProps> = React.forwardRef((props, ref) => {
       </DatagridRoot>
     </DatagridContextProvider>
   );
-});
+}) as FC<DatagridProps>;
 
 // @ts-ignore
 const createOrCloneElement = (element, props, children) =>
   isValidElement(element) ? cloneElement(element, props, children) : createElement(element, props, children);
 
-Datagrid.propTypes = {
-  // @ts-ignore
-  body: PropTypes.oneOfType([PropTypes.element, PropTypes.elementType]),
-  // @ts-ignore-line
-  bulkActionButtons: PropTypes.oneOfType([PropTypes.bool, PropTypes.element]),
-  children: PropTypes.node.isRequired,
-  className: PropTypes.string,
-  // @ts-ignore
-  sort: PropTypes.exact({
-    field: PropTypes.string,
-    order: PropTypes.oneOf(['ASC', 'DESC'] as const)
-  }),
-  data: PropTypes.arrayOf(PropTypes.any),
-  empty: PropTypes.element,
-  // @ts-ignore
-  expand: PropTypes.oneOfType([PropTypes.element, PropTypes.elementType]),
-  // @ts-ignore
-  header: PropTypes.oneOfType([PropTypes.element, PropTypes.elementType]),
-  hover: PropTypes.bool,
-  isLoading: PropTypes.bool,
-  onSelect: PropTypes.func,
-  onToggleItem: PropTypes.func,
-  resource: PropTypes.string,
-  // @ts-ignore
-  rowClick: PropTypes.oneOfType([PropTypes.string, PropTypes.func, PropTypes.bool]),
-  rowSx: PropTypes.func,
-  rowStyle: PropTypes.func,
-  selectedIds: PropTypes.arrayOf(PropTypes.any),
-  setSort: PropTypes.func,
-  total: PropTypes.number,
-  isRowSelectable: PropTypes.func,
-  isRowExpandable: PropTypes.func,
-  expandSingle: PropTypes.bool
-};
-
 const injectedProps = [
   'isRequired',
   'setFilter',

package/src/components/ra-lists/Datagrid/index.tsx

@@ -2,10 +2,7 @@ import { Datagrid as RaDatagrid } from './Datagrid';
 import { DatagridProps } from 'react-admin';
 import { styled } from '@mui/material/styles';
 
-const StyledDatagrid = styled(RaDatagrid, {
-  name: 'ApplicaDatagrid',
-  slot: 'root'
-})(({ theme }) => ({
+const StyledDatagrid = styled(RaDatagrid, { slot: 'root' })(({ theme }) => ({
   '& .RaBulkActionsToolbar-toolbar': {
     height: 48
   },

package/src/components/ra-lists/List.tsx

@@ -88,10 +88,7 @@ const RaList = <RecordType extends RaRecord = any>({
 
 const defaultFilter = {};
 
-const StyledList = styled(RaList, {
-  name: 'RaApplicaList',
-  slot: 'root'
-})(({ theme }) => ({
+const StyledList = styled(RaList, { slot: 'root' })(({ theme }) => ({
   '& .RaList-main': {
     overflowX: 'auto',
     '& .RaBulkActionsToolbar-toolbar': {

package/src/hooks/index.ts

@@ -12,3 +12,4 @@ export { useSx } from './mui';
 export { default as useTableFormIterator } from './useTableFormIterator';
 export { default as useTableFormIteratorItem } from './useTableFormIteratorItem';
 export { default as useThemeConfig } from './useThemeConfig';
+export { default as useApplicaAuthProvider } from './useApplicaAuthProvider';

package/src/hooks/useApplicaAuthProvider.js

@@ -0,0 +1,8 @@
+import { useAuthProvider } from 'ra-core';
+
+export const useApplicaAuthProvider = () => {
+  const authProvider = useAuthProvider();
+  return authProvider;
+};
+
+export default useApplicaAuthProvider;

package/src/hooks/useMemoizedObject.tsx

@@ -2,11 +2,9 @@ import _ from 'lodash';
 import { useEffect, useState } from 'react';
 
 /**
- * Questo hook memoizza in automatico un oggetto utilizzando il'equality check del suo valore come criterio di discriminazione.
- * NOTA BENE!!! L'equality check di un oggetto JS è un discorso estremamente complesso.
- * Pertanto questo hook va usato con estrema parsimonia, solo quando strettamente necessario e solo se si padroneggia a pieno il tema di cui sopra e le sue implicazioni nelle logiche di render condizionale di React
- * @param object
- * @returns
+ * This hook automatically memoizes an object using its value's equality check as a discrimination criterion.
+ * PLEASE NOTE!!! The equality check of a JS object is an extremely complex issue.
+ * Therefore, this hook should be used with extreme caution, only when strictly necessary and only if you fully master the topic above and its implications in the conditional rendering logic of React
  */
 function useMemoizedObject<T extends object>(object: T): T {
   if (!_.isPlainObject(object)) {

package/src/hooks/{useResourceTitle.jsx → useResourceTitle.ts}

@@ -2,7 +2,13 @@ import { useRecordContext, useResourceContext, useTranslate } from 'react-admin'
 
 import { useMemo } from 'react';
 
-const useResourceTitle = (title) => {
+/**
+ * Generate the title of a resource page from its name and the current record.
+ *
+ * @param title Can be the resource name, a fully qualified translation key, or a boolean to disable the title
+ * @returns The title of the resource, based on the current record and the resource name
+ */
+export function useResourceTitle(title: string | boolean | undefined): string | boolean | undefined {
   const record = useRecordContext();
   const translate = useTranslate();
   const resource = useResourceContext();
@@ -23,6 +29,6 @@ const useResourceTitle = (title) => {
   }, [mode, record, resource, translate, title]);
 
   return cardTitle;
-};
+}
 
 export default useResourceTitle;

package/src/index.jsx

@@ -25,6 +25,7 @@ export {
   EditContextProvider,
   email,
   FieldTitle,
+  FilterButton,
   Form,
   FormDataConsumer,
   HttpError,

package/src/playground/types.ts

@@ -46,17 +46,15 @@ export type ApplicaDataProviderConfig = {
 
 export type ApplicaDataProviderInterface = DataProvider & {
   /**
-   * Consente di ottenere l'url del servizio REST.
+   * Allows you to get the REST service URL.
    */
   getApiUrl(): string;
   /**
-   * Consente di recuperare un singolo file dal server utilizzando eventuali
-   * meccanismi di autenticazione associati al dataProvider (es. JWT passato mediante getHeaders).
+   * Allows you to retrieve a single file from the server using any mechanisms
+   * authentication associated with the dataProvider (e.g. JWT passed through getHeaders).
    *
-   * @param {String} resource URL del file da recuperare
-   * @returns {Promise} Restituisce una promise che contiene il file recuperato
-   *
-   * @example Simulazione del download di un file.
+   * @param resource Resource to request
+   * @example Simple download of a file
    * const attachment = await dataProvider.getFile(`/attachments/post/1/picture/1}`);
    * const link = document.createElement('a');
    * link.href = attachment;
@@ -66,29 +64,29 @@ export type ApplicaDataProviderInterface = DataProvider & {
    */
   getFile(resource: string): Promise<string>;
   /**
-   * Consente di eseguire una chiamata GET generica al servizio REST.
-   * La risposta del servizio deve contenere almeno 'responseCode' cosi come previsto da standard applica.
-   * Response code deve essere uguale ad 'ok' se la chiamata ha avuto successo.
+   * Allows you to make a generic GET call to the REST service.
+   * The service response must contain at least 'responseCode' as expected by the applica standard.
+   * Response code must be equal to 'ok' if the call was successful.
    *
    * @example
-   * // Esempio di chiamata: users?name=Roberto
+   * // Example: users?name=Roberto
    * const data = await dataProvider.get("users", { name: "Roberto" })
    *
    *
-   * @param resource Risorsa da richiedere
-   * @param params Parametri della query string da inserire
+   * @param resource Resource to request
+   * @param params Query string parameters to insert
    */
   get(resource: string, params: any): Promise<any>;
   /**
-   * Consente di eseguire una chiamata POST generica al servizio REST.
-   * La risposta del servizio deve contenere almeno 'responseCode' cosi come previsto da standard applica.
-   * Response code deve essere uguale ad 'ok' se la chiamata ha avuto successo.
+   * Allows you to make a generic POST call to the REST service.
+   * The service response must contain at least 'responseCode' as expected by the applica standard.
+   * Response code must be equal to 'ok' if the call was successful.
    *
    * @example
    * const data = await dataProvider.post("users", { name: "Roberto" })
    *
-   * @param resource Risorsa da richiedere
-   * @param params Parametri della query string da inserire
+   * @param resource Resource to request
+   * @param params Query string parameters to insert
    */
   post(resource: string, params: any): Promise<any>;
 };