@applica-software-guru/react-admin 1.3.151 → 1.3.152

package/dist/utils/localizedValue.d.ts

@@ -1,11 +1,18 @@
+type ILocale = {
+    name: string;
+    locale: string;
+};
 type ILocalizedValue<T> = {
     [key: string]: T;
 };
-declare function localizedValueHasAllLocales<T>(value?: ILocalizedValue<T>, locales?: Array<{
-    name: string;
-    locale: string;
-}>, options?: {
+declare function localizedValueHasAllLocales<T>(value?: ILocalizedValue<T>, locales?: Array<ILocale>, options?: {
     isEmpty?: (v: T) => boolean;
 }): boolean;
-export { localizedValueHasAllLocales };
+type IGetLocalizedValueOptions = {
+    fallback?: boolean;
+    fallbackLocales?: Array<string>;
+};
+declare function getLocalizedValue<T>(value: ILocalizedValue<T>, locale: string, options?: IGetLocalizedValueOptions): T | undefined;
+export type { ILocalizedValue, IGetLocalizedValueOptions };
+export { localizedValueHasAllLocales, getLocalizedValue };
 //# sourceMappingURL=localizedValue.d.ts.map

package/dist/utils/localizedValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"localizedValue.d.ts","sourceRoot":"","sources":["../../../src/utils/localizedValue.ts"],"names":[],"mappings":"AACA,KAAK,eAAe,CAAC,CAAC,IAAI;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAA;CAAE,CAAC;AAE/C,iBAAS,2BAA2B,CAAC,CAAC,EACpC,KAAK,GAAE,eAAe,CAAC,CAAC,CAAM,EAC9B,OAAO,GAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAM,EACrD,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,CAAA;CAAO,GAC5C,OAAO,CAIT;AAED,OAAO,EAAE,2BAA2B,EAAE,CAAC"}
+{"version":3,"file":"localizedValue.d.ts","sourceRoot":"","sources":["../../../src/utils/localizedValue.ts"],"names":[],"mappings":"AACA,KAAK,OAAO,GAAG;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AACF,KAAK,eAAe,CAAC,CAAC,IAAI;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAA;CAAE,CAAC;AAE/C,iBAAS,2BAA2B,CAAC,CAAC,EACpC,KAAK,GAAE,eAAe,CAAC,CAAC,CAAM,EAC9B,OAAO,GAAE,KAAK,CAAC,OAAO,CAAM,EAC5B,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,CAAA;CAAO,GAC5C,OAAO,CAIT;AAED,KAAK,yBAAyB,GAAG;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACjC,CAAC;AACF,iBAAS,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,CAAC,GAAG,SAAS,CAwB3H;AAED,YAAY,EAAE,eAAe,EAAE,yBAAyB,EAAE,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@applica-software-guru/react-admin",
-  "version": "1.3.151",
+  "version": "1.3.152",
   "private": false,
   "repository": {
     "type": "git",

package/src/hooks/index.jsx

@@ -21,3 +21,4 @@ export {
 export { useSx } from './mui';
 export { useRefDimensions } from './useRefDimensions';
 export { useMemoizedObject } from './useMemoizedObject';
+export { useLocalizedValue, useGetLocalizedValue } from './useLocalizedValue';

package/src/hooks/useLocalizedValue.tsx

@@ -0,0 +1,34 @@
+import { useLocaleState } from 'ra-core';
+import { IGetLocalizedValueOptions, ILocalizedValue, getLocalizedValue } from '../utils';
+import { useCallback } from 'react';
+
+function useLocale(locale?: string): string {
+  const [defaultLocale] = useLocaleState();
+
+  return locale !== undefined ? String(locale) : defaultLocale;
+}
+
+type IUseLocalizeValueOptions = IGetLocalizedValueOptions & {
+  locale?: string;
+};
+function useLocalizedValue<T>(value: ILocalizedValue<T>, options?: IUseLocalizeValueOptions): T | undefined {
+  const language = useLocale(options?.locale),
+    localizedValue = getLocalizedValue<T>(value, language, options);
+
+  return localizedValue;
+}
+
+type IUseGetLocalizeValueOptions = IUseLocalizeValueOptions;
+function useGetLocalizedValue<T>(options?: IUseGetLocalizeValueOptions): (v: ILocalizedValue<T>) => T | undefined {
+  const language = useLocale(options?.locale),
+    callback = useCallback(
+      (value: ILocalizedValue<T>) => {
+        return getLocalizedValue<T>(value, language, options);
+      },
+      [language, options]
+    );
+
+  return callback;
+}
+
+export { useLocalizedValue, useGetLocalizedValue };

package/src/utils/localizedValue.ts

@@ -1,9 +1,13 @@
 import _ from 'lodash';
+type ILocale = {
+  name: string;
+  locale: string;
+};
 type ILocalizedValue<T> = { [key: string]: T };
 
 function localizedValueHasAllLocales<T>(
   value: ILocalizedValue<T> = {},
-  locales: Array<{ name: string; locale: string }> = [],
+  locales: Array<ILocale> = [],
   options: { isEmpty?: (v: T) => boolean } = {}
 ): boolean {
   const { isEmpty = _.isEmpty } = options;
@@ -11,4 +15,35 @@ function localizedValueHasAllLocales<T>(
   return !_.some(locales, (l) => isEmpty((value ?? {})[l.locale]));
 }
 
-export { localizedValueHasAllLocales };
+type IGetLocalizedValueOptions = {
+  fallback?: boolean;
+  fallbackLocales?: Array<string>;
+};
+function getLocalizedValue<T>(value: ILocalizedValue<T>, locale: string, options?: IGetLocalizedValueOptions): T | undefined {
+  if (!_.isPlainObject(value) || locale === undefined) {
+    return undefined;
+  }
+
+  const _options: IGetLocalizedValueOptions = _.isPlainObject(options) ? (options as IGetLocalizedValueOptions) : {},
+    fallback = Boolean(_options?.fallback ?? true);
+
+  let localizedValue: T | undefined = value[String(locale)];
+
+  if (localizedValue === undefined && fallback) {
+    const fallbackLocales = _.isArray(_options.fallbackLocales) && !_.isEmpty(_options.fallbackLocales) ? _options.fallbackLocales : ['en'];
+    localizedValue = _.chain(fallbackLocales)
+      .map((l) => value[String(l)])
+      .reject(_.isUndefined)
+      .first()
+      .value() as T | undefined;
+
+    if (localizedValue === undefined) {
+      localizedValue = _.chain(value).values().first().value() as T | undefined;
+    }
+  }
+
+  return localizedValue;
+}
+
+export type { ILocalizedValue, IGetLocalizedValueOptions };
+export { localizedValueHasAllLocales, getLocalizedValue };