@fto-consult/expo-ui 6.77.6 → 6.78.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fto-consult/expo-ui",
-  "version": "6.77.6",
+  "version": "6.78.0",
   "description": "Bibliothèque de composants UI Expo,react-native",
   "main": "main",
   "scripts": {
@@ -71,7 +71,7 @@
     "@expo/html-elements": "^0.5.1",
     "@expo/vector-icons": "^13.0.0",
     "@faker-js/faker": "^8.0.2",
-    "@fto-consult/common": "^3.62.10",
+    "@fto-consult/common": "^3.63.0",
     "@pchmn/expo-material3-theme": "^1.3.1",
     "@react-native-async-storage/async-storage": "1.18.2",
     "@react-native-community/datetimepicker": "7.2.0",

package/src/components/Datagrid/Common/Common.js

@@ -39,7 +39,7 @@ import { renderRowCell,formatValue,arrayValueSeparator } from "./utils";
 import Button from "$ecomponents/Button";
 import stableHash from "stable-hash";
 import * as XLSX from "xlsx";
-import {convertToSQL} from "$ecomponents/Filter";
+import {parseMangoQueries} from "$ecomponents/Filter";
 import events from "../events";
 import {MORE_ICON} from "$ecomponents/Icon"
 import ActivityIndicator from "$ecomponents/ActivityIndicator";
@@ -1874,7 +1874,8 @@ export default class CommonDatagridComponent extends AppComponent {
          })
     }).finally(Preloader.close);
 }
-   handleTableExport({sessionKeyName,excel,pdf,isOnlytotal,displayOnlyHeader,data:config}){
+   handleTableExport(args){
+        let {sessionKeyName,excel,pdf,isOnlytotal,displayOnlyHeader,data:config} = args;
         this.setSessionData(sessionKeyName,config);
         config.fileName = sprintf(config.fileName);
         config.sheetName = sanitizeSheetName(config.sheetName);
@@ -1979,7 +1980,7 @@ export default class CommonDatagridComponent extends AppComponent {
                 }
             });
         }
-        return {data,headers,config}
+        return {...args,data,headers,config}
     }
    
    renderExportableMenu(){
@@ -3193,9 +3194,9 @@ export default class CommonDatagridComponent extends AppComponent {
         if(this.isClearingAllFilters) return;
         return this.doFilter(arg);
     }
-    ///si les filtres devront être convertis au format SQL
+    ///si les filtres devront être parsé, pour être preparés au format SQL
     canConvertFiltersToSQL(){
-        return !!(this.props.convertFiltersToSQL);;
+        return !!(this.props.parseMangoQueries);;
     }
     /*** retourne la liste des colonnes sur lesquelles on peut effectuer un filtre*/
     getFilterableColumnsNames(){ 
@@ -3204,15 +3205,15 @@ export default class CommonDatagridComponent extends AppComponent {
     }
     /*** récupère les filtres en cours du datagrid
      * @param {boolean} prepare si les filtres seront apprêtés grace à la méthode prepareFilters de $cFilters 
-     * @param {boolean} convertFiltersToSQL si les filtres seront convertis au formatSQL
+     * @param {boolean} parseMangoQueries, si l'on doit parser les filtres initialement au format mangoqueries, les preparer au format SQL
      */
     getFilters(args){
         args = defaultObj(args);
         const prepare = typeof args.prepare =='boolean'? args.prepare : typeof args.prepareFilters =='boolean' ? args.prepareFilters : true;
         this.filters = extendObj(true,{},this.filteredValues,this.filters);
-        const convertFiltersToSQL = typeof args.convertToSQL =="boolean"? args.convertToSQL : typeof args.convertFiltersToSQL =="boolean"? args.convertFiltersToSQL : false;
+        const parseMangoQueries = typeof args.parseMangoQueries =="boolean"? args.parseMangoQueries : typeof args.parseMangoQueries =="boolean"? args.parseMangoQueries : false;
         if(prepare === false) return this.filters;
-        return prepareFilters(this.filters,{filter:this.canHandleFilterVal.bind(this),convertToSQL:convertFiltersToSQL});
+        return prepareFilters(this.filters,{filter:this.canHandleFilterVal.bind(this),parseMangoQueries});
     }
     hasFilters (){
         if(!this.isFilterable()) return false;
@@ -3300,14 +3301,14 @@ export default class CommonDatagridComponent extends AppComponent {
                     force = cb;
                     cb = undefined;
                 }
-                fetchOptions = this.getFetchOptions({fetchOptions,convertToSQL:false});
+                fetchOptions = this.getFetchOptions({fetchOptions,parseMangoQueries:false});
                 if(typeof this.props.fetchOptionsMutator =='function' && this.props.fetchOptionsMutator(fetchOptions) === false){
                     this.isFetchingData = false;
                     return resolve(sData);
                 }
                 if(this.beforeFetchData({fetchOptions,force,context:this,renderProgressBar}) === false) return resolve(sData);
                 if(this.canConvertFiltersToSQL()){
-                    fetchOptions.selector = convertToSQL(fetchOptions.selector);
+                    fetchOptions.selector = parseMangoQueries(fetchOptions.selector);
                 }
                 if(typeof this.props.beforeFetchData =='function' && this.props.beforeFetchData({...rest,renderProgressBar,context:this,force,fetchOptions,options:fetchOptions}) === false){
                     this.isFetchingData = false;
@@ -3462,7 +3463,7 @@ export default class CommonDatagridComponent extends AppComponent {
     }
     /*** récupère les fetchOptions du datagrid */
     getFetchOptions({fetchOptions}){
-        const fetchFilters = this.getFilters({convertToSQL : false});
+        const fetchFilters = this.getFilters({parseMangoQueries : false});
         fetchOptions = Object.clone(isObj(fetchOptions)? fetchOptions : {});
         fetchOptions.selector = defaultObj(fetchOptions.selector);
         fetchOptions.dataSources = this.currentDataSources;
@@ -3951,7 +3952,7 @@ CommonDatagridComponent.propTypes = {
     ]),
     filterable : PropTypes.bool, //si le composant peut être filtrable
     /*** si les filtres de données seront convertis au format SQL avant d'effectuer la requête distante */
-    convertFiltersToSQL : PropTypes.bool,
+    parseMangoQueries : PropTypes.bool,
     isLoading : PropTypes.bool,///si les données sont en train d'être chargées
     session : PropTypes.bool, /// si les données de sessions seront persistées
     exportTableProps : PropTypes.oneOfType([

package/src/components/Datagrid/Common/TableData.js

@@ -4,8 +4,8 @@ import PropTypes from "prop-types";
 import actions from "$actions";
 /**** 
  *      la fonction fetchOptionsMutator permet éventuellemnt de faire une mutations sur les options fetchOptions avant qu'elle ne soit appliquée pour la recherche. elle
- *      est appelée avant que la fonction convertToSQL ne soit appelée, bien évidemement si la props convertToSQL est active pour le datagrid
- *      la fonction beforeFetchData est appelée immédiatement avant l'execution de la requête fetch et après que la fonction converttoSQL soit appelée
+ *      est appelée avant que la fonction parseMangoQueriesToSQL ne soit appelée, bien évidemement si la props parseMangoQueriesToSQL est active pour le datagrid
+ *      la fonction beforeFetchData est appelée immédiatement avant l'execution de la requête fetch et après que la fonction parseMangoQueriestoSQL soit appelée
  */
 export default class CommonTableDatagrid extends CommonDatagrid{
     constructor(props){

package/src/components/Datagrid/SWRDatagrid.js

@@ -175,7 +175,7 @@ const SWRDatagridComponent = React.forwardRef((props,ref)=>{
             opts = defaultObj(opts);
             opts.fetchOptions = isObj(opts.fetchOptions)? Object.clone(opts.fetchOptions) : {};
             extendObj(true,opts.fetchOptions,fetchOptionsRef.current);
-            if(props.convertFiltersToSQL === false){
+            if(props.parseMangoQueries === false){
                 opts.fetchOptions.selector = extendObj(true,{},opts.fetchOptions.selector,fetchOptionsRef.current?.selector);
             }
             opts.fetchOptions.sort = sortRef.current;

package/src/components/Form/Fields/SelectTableData/Component.js

@@ -7,7 +7,7 @@ import {defaultStr,extendObj,isFunction,defaultVal,isObjOrArray,defaultObj} from
 import PropTypes from "prop-types";
 import actions from "$cactions";
 import {navigateToTableData} from "$enavigation/utils";
-import {getFetchOptions,prepareFilters,convertToSQL as convFiltersToSQL} from "$cutils/filters";
+import {getFetchOptions,prepareFilters,parseMangoQueries as filtersParseMangoQueries} from "$cutils/filters";
 import fetch from "$capi"
 import React from "$react";
 import useApp from "$econtext/hooks";
@@ -19,7 +19,7 @@ import DateLib from "$lib/date";
  *  foreignKeyTable : la tableData dans laquelle effectuer les donées de la requêtes
  *  foreignKeyLabel : Le libélé dans la table étrangère
  */
-const TableDataSelectField = React.forwardRef(({foreignKeyColumn,foreignKeyLabelRenderers,isStructData,getForeignKeyTable:cGetForeignKeyTable,prepareFilters:cPrepareFilters,bindUpsert2RemoveEvents,onAdd,showAdd:customShowAdd,canShowAdd,foreignKeyTable,fetchItemsPath,foreignKeyLabel,foreignKeyLabelIndex,dropdownActions,fields,fetchItems:customFetchItem,convertFiltersToSQL,mutateFetchedItems,onFetchItems,isFilter,isUpdate,isDocEditing,items,onAddProps,fetchOptions,...props},ref)=>{
+const TableDataSelectField = React.forwardRef(({foreignKeyColumn,foreignKeyLabelRenderers,isStructData,getForeignKeyTable:cGetForeignKeyTable,prepareFilters:cPrepareFilters,bindUpsert2RemoveEvents,onAdd,showAdd:customShowAdd,canShowAdd,foreignKeyTable,fetchItemsPath,foreignKeyLabel,foreignKeyLabelIndex,dropdownActions,fields,fetchItems:customFetchItem,parseMangoQueries,mutateFetchedItems,onFetchItems,isFilter,isUpdate,isDocEditing,items,onAddProps,fetchOptions,...props},ref)=>{
     props.data = defaultObj(props.data);
     const type = defaultStr(props.type)?.toLowerCase();
     isStructData = isStructData || type?.replaceAll("-","").replaceAll("_","").trim().contains("structdata");
@@ -37,7 +37,7 @@ const TableDataSelectField = React.forwardRef(({foreignKeyColumn,foreignKeyLabel
         }
     }
     const getForeignKeyTable = typeof cGetForeignKeyTable =='function'? cGetForeignKeyTable : isStructData ? getStructData: appGetForeignKeyTable;
-    convertFiltersToSQL = defaultBool(convertFiltersToSQL,datagrid?.convertFiltersToSQL);
+    parseMangoQueries = defaultBool(parseMangoQueries,datagrid?.parseMangoQueries);
     const foreignKeyTableStr = defaultStr(foreignKeyTable,props.tableName,props.table);
     if(typeof getForeignKeyTable !=='function'){
         console.error("la fonction getTableData non définie des les paramètres d'initialisation de l'application!!! Rassurez vous d'avoir définier cette fonction!!, options : foreignKeyTable:",foreignKeyTable,"foreignKeyColumn:",foreignKeyColumn,props)
@@ -147,8 +147,8 @@ const TableDataSelectField = React.forwardRef(({foreignKeyColumn,foreignKeyLabel
             if(!isMounted()) return;
             if(typeof beforeFetchItems ==='function' && beforeFetchItems({fetchOptions}) === false) return;
             let opts = Object.clone(fetchOptions);
-            if(convertFiltersToSQL){
-                opts.selector = convFiltersToSQL(opts.selector);
+            if(parseMangoQueries){
+                opts.selector = filtersParseMangoQueries(opts.selector);
                 opts = getFetchOptions(opts);
                 delete opts.selector;
             } else {
@@ -357,7 +357,7 @@ TableDataSelectField.propTypes = {
     itemValue : PropTypes.func,
     renderItem : PropTypes.func,
     renderText : PropTypes.func,
-    convertFiltersToSQL : PropTypes.oneOfType([
+    parseMangoQueries : PropTypes.oneOfType([
         PropTypes.func,
         PropTypes.bool,
     ]),// si l'on doit convertir les selecteurs de filtres au format SQl

package/src/context/Provider.js

@@ -52,7 +52,7 @@ Object.map(Utils,(v,i)=>{
     }, la liste des tables de données
     structsData : {object}, la liste des données de structures
     handleHelpScreen : {boolean}, //si l'écran d'aide sera pris en compte, l'écran d'aide ainsi que les écrans des termes d'utilisations et autres
-    convertFiltersToSQL : {boolean}, si les filtres de datagrid ou filtres seront convertis au format SQL
+    parseMangoQueries : {boolean}, si les filtres de datagrid ou filtres seront convertis au format SQL
     components : {
         MainProvider : {ReactComponent}, //le composant qui permet de wrapper le contenu de l'application expo. Nb, ce composant ne peut utiliser ni les routes, nis les DialogProvider,
         logo : ReactNode | ReactComponent | object {
@@ -88,7 +88,7 @@ Object.map(Utils,(v,i)=>{
     swrConfig : {object},//les paramètres de configuration de l'objet swr utilisée dans le composant SWRDatagrid
     realm : {}, //les options de configurations de la base de données realmdb
 */
-const Provider = ({children,getTableData,handleHelpScreen,navigation,swrConfig,auth:cAuth,components:cComponents,convertFiltersToSQL,getStructData,tablesData,structsData,...props})=>{
+const Provider = ({children,getTableData,handleHelpScreen,navigation,swrConfig,auth:cAuth,components:cComponents,parseMangoQueries,getStructData,tablesData,structsData,...props})=>{
     require('$session');///initializing session
     const {extendAppTheme} = appConfig;
     const { theme : pTheme } = useMaterial3Theme();
@@ -165,8 +165,8 @@ const Provider = ({children,getTableData,handleHelpScreen,navigation,swrConfig,a
         }
       }
     },swrConfig);
-    if(convertFiltersToSQL !== undefined){
-      appConfig.set("convertFiltersToSQL",convertFiltersToSQL);
+    if(parseMangoQueries !== undefined){
+      appConfig.set("parseMangoQueries",parseMangoQueries);
     }
     const colorScheme = useColorScheme();
     const isColorShemeDark = colorScheme ==="dark";
@@ -300,7 +300,7 @@ const Provider = ({children,getTableData,handleHelpScreen,navigation,swrConfig,a
         ...props,
         handleHelpScreen,
         navigation,
-        convertFiltersToSQL,
+        parseMangoQueries,
         auth,
         components : {
             ...components,