datastake-daf 0.6.756 → 0.6.758

package/src/helpers/breadCrumbs.js

@@ -0,0 +1,347 @@
+
+export const  buildBreadCrumbs = ({
+    config,
+    items,
+    t,
+    breadCrumbsLabels,
+    id,
+    getRedirectLink,
+    createOnClick,
+    goTo,
+    view,
+    skipInteractions = false,
+}) => {
+    const pathConfig = config.path || [];
+
+    pathConfig.forEach((pathItem) => {
+        if (typeof pathItem === 'string') {
+            items.push({
+                label: t(breadCrumbsLabels[pathItem]),
+                onClick: () => {},
+            });
+        } else if (typeof pathItem === 'object') {
+            const { key, link, useRedirect } = pathItem;
+
+            if (key === 'id' && id) {
+                const resolvedLink = typeof link === 'function' ? link(id) : link;
+                const finalLink = useRedirect ? getRedirectLink(resolvedLink) : resolvedLink;
+
+                items.push({
+                    label: id,
+                    onClick: skipInteractions ? () => {} : (finalLink ? createOnClick(() => goTo(finalLink)) : () => {}),
+                });
+            } else {
+                const resolvedLink = typeof link === 'function' ? link(view, id) : link;
+                const finalLink = resolvedLink && useRedirect ? getRedirectLink(resolvedLink) : resolvedLink;
+
+                items.push({
+                    label: t(breadCrumbsLabels[key]),
+                    onClick: skipInteractions ? () => {} : (finalLink ? createOnClick(() => goTo(finalLink)) : () => {}),
+                });
+            }
+        }
+    });
+
+    if (config.includeId && id && id !== 'user') {
+        items.push({ label: id, onClick: () => {} });
+    }
+
+    if (config.suffix) {
+        config.suffix.forEach((suffixItem) => {
+            items.push({
+                label: t(breadCrumbsLabels[suffixItem]),
+                onClick: () => {},
+            });
+        });
+    }
+}
+
+export const renderBreadCrumbs = ({ 
+    t = () => {},
+    goTo = () => {},
+    view,
+    isAnalysis = false,
+    isEdit = false,
+    isView = false,
+    isDataStore = false,
+    id,
+    addedItems = [],
+    changeNotificationState,
+    breadCrumbConfig = {},
+    breadCrumbsLabels = {},
+    getRedirectLink = () => {},
+    condition,
+    conditionFallback = 'show-non-interactive', // 'show-non-interactive' | 'hide' | 'show-simplified'
+}) => {
+    const items = [];
+
+    const createOnClick = (callback) => {
+        if (!callback) return () => {};
+        
+        return () => {
+            if (changeNotificationState) {
+                changeNotificationState({ onYes: callback });
+            } else {
+                callback();
+            }
+        };
+    };
+
+    const evaluateCondition = (cond, context) => {
+        if (cond === undefined) return true; // No condition = always pass
+        if (typeof cond === 'function') return cond(context); // Function condition
+        return Boolean(cond); // Boolean condition
+    };
+
+    const config = breadCrumbConfig[view];
+
+    console.log({config, breadCrumbConfig, breadCrumbsLabels, condition})
+
+    if (config) {
+        const conditionContext = {
+            isDataStore,
+            isAnalysis,
+            isEdit,
+            isView,
+            id,
+            view,
+            t,
+            goTo,
+            getRedirectLink,
+            changeNotificationState,
+            addedItems,
+        };
+
+        const externalConditionPassed = evaluateCondition(condition, conditionContext);
+        const configConditionPassed = evaluateCondition(config.condition, conditionContext);
+        
+        const shouldShowBreadcrumbs = externalConditionPassed && configConditionPassed;
+
+        if (!configConditionPassed) {
+            if (config.fallback) {
+                buildBreadCrumbs({
+                    config: config.fallback,
+                    items,
+                    t,
+                    breadCrumbsLabels,
+                    id,
+                    getRedirectLink,
+                    createOnClick,
+                    goTo,
+                    view,
+                });
+            }
+        } else if (!externalConditionPassed) {
+            if (config.fallback) {
+                // Use config fallback when prop condition fails
+                buildBreadCrumbs({
+                    config: config.fallback,
+                    items,
+                    t,
+                    breadCrumbsLabels,
+                    id,
+                    getRedirectLink,
+                    createOnClick,
+                    goTo,
+                    view,
+                });
+            }
+            else {                
+                switch (conditionFallback) {
+                    case 'hide':
+                        break;
+                    case 'show-simplified':{
+                        const simplifiedConfig = {
+                            ...config,
+                            path: config.path.slice(0, 2), 
+                            includeId: false,
+                            suffix: undefined,
+                        };
+    
+                        buildBreadCrumbs({
+                            config: simplifiedConfig,
+                            items,
+                            t,
+                            breadCrumbsLabels,
+                            id,
+                            getRedirectLink,
+                            createOnClick,
+                            goTo,
+                            view,
+                        });
+                        break;
+                    }
+                    case 'show-non-interactive':
+                    default:
+                        buildBreadCrumbs({
+                            config,
+                            items,
+                            t,
+                            breadCrumbsLabels,
+                            id,
+                            getRedirectLink,
+                            createOnClick,
+                            goTo,
+                            view,
+                            skipInteractions: true,
+                        });
+                        break;
+                }
+            }
+        } else {
+            buildBreadCrumbs({
+                config,
+                items,
+                t,
+                breadCrumbsLabels,
+                id,
+                getRedirectLink,
+                createOnClick,
+                goTo,
+                view,
+            });
+        }
+    }
+
+
+	if (isView) {
+		items.push({ label: t(breadCrumbsLabels.details) });
+	} else if (isEdit) {
+		items.push({ label: t(breadCrumbsLabels.edit) });
+	} else if (isAnalysis) {
+		items.push({ label: t(breadCrumbsLabels.summary) });
+	}
+
+	items.push(...addedItems);
+
+	return items.filter((v) => !!v.label);
+
+}
+
+// Breadcrumbs Config Helper
+
+// 1.Simple static path
+// 'country-overview': {
+//     path: ['analysis', 'country-overview'],
+// }
+// Result: Analysis > Country Overview
+// Neither is clickable
+
+// 2.Clickable Parents with Links
+// 'mines': {
+//     path: [
+//         'modules',  // Not clickable
+//         { key: 'mines', link: '/app/mines' }  // Clickable, navigates to /app/mines
+//     ],
+// }
+// Result: Modules > Mines (clickable)
+
+// 3.Include ID at the end
+// 'partners': {
+//     path: ['modules', { key: 'partners', link: '/app/partners', useRedirect: true }],
+//     includeId: true,  // ← ID will be added at the end
+// }
+// With id='ABC123':
+// Result: Modules > Partners (clickable) > ABC123 (not clickable)
+
+// 4.Dynamic Id in the middle
+// 'mine-evaluation': {
+//     path: [
+//         'modules',
+//         { key: 'mines', link: '/app/mines' },
+//         { key: 'id', link: (id) => `/app/mines/${id}` },  // ← ID here
+//         'evaluation',
+//     ],
+// }
+// With id='MINE-456':
+// Result: Modules > Mines > MINE-456 (clickable to /app/mines/MINE-456) > Evaluation
+
+// 5. Dynamic Links using functions
+// 'producers': {
+//     path: [
+//         'modules',
+//         { 
+//             key: 'producers', 
+//             link: (view) => `/app/${view}`,  // ← Uses 'view' parameter
+//             useRedirect: true 
+//         }
+//     ],
+//     includeId: true,
+// }
+// With view='producers':
+// Result: Modules > Producers (navigates to /app/producers)
+
+// 6.use Redirect link
+// 'settings': {
+//     path: [
+//         { 
+//             key: 'settings', 
+//             link: '/app/view/settings', 
+//             useRedirect: true  // ← Wraps with getRedirectLink()
+//         }
+//     ],
+// }
+// Navigation will use getRedirectLink('/app/view/settings')
+
+// 7.Conditional Rendering
+// 'entities': {
+//     condition: (opts) => opts.isDataStore,  // ← Only shows if isDataStore=true
+//     path: [
+//         'data',
+//         { key: 'data-store', link: '/app/data-store', useRedirect: true },
+//         { key: 'entities', link: '/app/data-store/entities', useRedirect: true },
+//     ],
+// }
+// With isDataStore=false: No breadcrumbs shown
+// With isDataStore=true: Data > Store > Entities
+
+// 8.Conditional Fallback
+// 'locations': {
+//     condition: (opts) => opts.isDataStore,
+//     path: [
+//         'data',
+//         { key: 'data-store', link: '/app/data-store', useRedirect: true },
+//         { key: 'locations', link: '/app/data-store/locations', useRedirect: true },
+//     ],
+//     fallback: {  // ← Alternative when condition is false
+//         path: [
+//             'modules',
+//             'linkedSubjects',
+//             { key: 'locations', link: '/app/locations', useRedirect: true },
+//         ],
+//         includeId: true,
+//     },
+// }
+// isDataStore=true: Data > Store > Locations
+// isDataStore=false: Modules > Associated Information > Locations > {id}
+
+// 9. Suffix items
+// 'mine-monitoring': {
+//     path: [
+//         'modules',
+//         { key: 'mines', link: '/app/mines' }
+//     ],
+//     includeId: true,
+//     suffix: ['visits'],  // ← Added at the end
+// }
+// With id='MINE-789':
+// Result: Modules > Mines > MINE-789 > Visits
+
+// 10. Complex multi level path
+// 'monitoringReport': {
+//     path: [
+//         'modules',  // Static label
+//         { key: 'mines', link: '/app/mines' },  // Clickable parent
+//         { key: 'id', link: (id) => `/app/mines/${id}` },  // Dynamic ID with link
+//         'monitoringReport',  // Static label at end
+//     ],
+// }
+// With id='MINE-999':
+// Result: Modules > Mines (→/app/mines) > MINE-999 (→/app/mines/MINE-999) > Executive Monitoring Report
+
+// 11. Access multiple options in condition
+// 'custom-view': {
+//     condition: (opts) => opts.isDataStore && opts.isEdit && opts.id,
+//     path: ['data', 'custom'],
+// }
+// Available in opts: { isDataStore, isAnalysis, isEdit, isView, id, view }

package/src/utils.js

@@ -58,4 +58,6 @@ export {
 	buildActionWidgetsConfig, 
 	buildKeyIndicatorsConfig, 
 	buildBreadcrumbs
-} from './@daf/utils/adminConfigBuilders.js'
+} from './@daf/utils/adminConfigBuilders.js'
+
+export { renderBreadCrumbs, buildBreadCrumbs as buildBreadCrumbsHelper } from './helpers/breadCrumbs.js'