@appcorp/fusion-storybook 0.1.64 → 0.1.65

package/base-modules/family/context.js

@@ -18,7 +18,7 @@
  * - `FAMILY_DRAWER` — drawer type constants
  * - `useFamilyModule()` — hook that returns state, dispatch, and handlers
  */
-import { useCallback, useEffect, useMemo } from "react";
+import { useCallback, useEffect, useMemo, useRef } from "react";
 import { isCreatedOrUpdated, validateForm, } from "@react-pakistan/util-functions";
 import { useModuleEntityV2, } from "@react-pakistan/util-functions/hooks/use-module-entity-v2";
 import { useDebounce } from "@react-pakistan/util-functions/hooks/use-debounce";
@@ -31,8 +31,9 @@ import { generateThemeToast, TOAST_VARIANT, } from "@appcorp/shadcn/lib/toast-ut
 import { useTranslations } from "next-intl";
 import { getCachedWorkspaceSync } from "../workspace/cache";
 import { Eye, Filter, MoreHorizontal, Pencil, Plus } from "lucide-react";
+import { useTheme } from "next-themes";
 // ============================================================================
-// DRAWER TYPES
+// 1.1 DRAWER TYPES
 // ============================================================================
 export const FAMILY_DRAWER = {
     FILTER_DRAWER: DRAWER_TYPES.FILTER_DRAWER,
@@ -41,7 +42,7 @@ export const FAMILY_DRAWER = {
     VIEW_DRAWER: DRAWER_TYPES.VIEW_DRAWER,
 };
 // ============================================================================
-// CONFIGURATION
+// 1.2 MODULE CONFIGURATION
 // ============================================================================
 const familyConfig = {
     name: "Family",
@@ -73,7 +74,7 @@ const familyConfig = {
     drawerTypes: DRAWER_TYPES,
 };
 // ============================================================================
-// CREATE FAMILY MODULE
+// 1.3 CREATE FAMILY MODULE
 // ============================================================================
 export const { actionTypes: FAMILY_ACTION_TYPES, config: familyModuleConfig, initialState: initialFamilyState, Provider: FamilyProvider, reducer: familyReducer, useContext: useFamilyContext, } = createGenericModule(familyConfig);
 /**
@@ -81,17 +82,24 @@ export const { actionTypes: FAMILY_ACTION_TYPES, config: familyModuleConfig, ini
  */
 export const FamilyStateContextProvider = FamilyProvider;
 // ============================================================================
-// ENHANCED FAMILY HOOK WITH API INTEGRATION
+// 1.4 ENHANCED FAMILY HOOK WITH API INTEGRATION
 // ============================================================================
 export const useFamilyModule = () => {
+    // ==========================================================================
+    // 1.4.1 STATE & CORE HOOKS
+    // ==========================================================================
     var _a, _b;
-    const { state, dispatch } = useFamilyContext();
+    const context = useFamilyContext();
+    const { dispatch } = context;
+    const state = context.state;
     const t = useTranslations("family");
+    const { theme } = useTheme();
     const workspace = getCachedWorkspaceSync();
+    const listFetchNowRef = useRef(null);
     const debouncedQuery = useDebounce(state.searchQuery, 800);
-    // ============================================================================
-    // API PARAMETERS
-    // ============================================================================
+    // ==========================================================================
+    // 1.4.2 API PARAMETERS
+    // ==========================================================================
     const listParams = useMemo(() => {
         var _a;
         return (Object.assign(Object.assign({ currentPage: state.currentPage, pageLimit: state.pageLimit, schoolId: ((_a = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _a === void 0 ? void 0 : _a.id) || "" }, (debouncedQuery ? { searchQuery: debouncedQuery } : {})), (state.filterEnabled !== undefined
@@ -125,10 +133,40 @@ export const useFamilyModule = () => {
     ]);
     const byIdParams = useMemo(() => ({ id: state.id }), [state.id]);
     const deleteParams = useMemo(() => ({ id: state.id }), [state.id]);
-    // ============================================================================
-    // API CALLBACKS
-    // ============================================================================
-    const listCallback = ({ data, error }) => {
+    // ==========================================================================
+    // 1.4.3 UTILITIES
+    // ==========================================================================
+    const showToast = useCallback((description, variant) => {
+        generateThemeToast({
+            description,
+            theme: theme,
+            variant,
+        });
+    }, [theme]);
+    const resetFormAndCloseDrawer = useCallback(() => {
+        dispatch({
+            type: FAMILY_ACTION_TYPES.SET_ERRORS,
+            payload: { errors: {} },
+        });
+        dispatch({
+            type: FAMILY_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
+            payload: { disabled: false },
+        });
+        dispatch({
+            type: FAMILY_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: null },
+        });
+    }, [dispatch]);
+    const setField = useCallback((key, value) => {
+        dispatch({
+            type: FAMILY_ACTION_TYPES.SET_INPUT_FIELD,
+            payload: { key, value: value === null ? undefined : value },
+        });
+    }, [dispatch]);
+    // ==========================================================================
+    // 1.4.4 API CALLBACKS
+    // ==========================================================================
+    const listCallback = useCallback(({ data, error }) => {
         if (error) {
             showToast(t("messagesFetchFailed"), TOAST_VARIANT.ERROR);
             return;
@@ -139,8 +177,9 @@ export const useFamilyModule = () => {
                 payload: { items: data.items || [], count: data.count || 0 },
             });
         }
-    };
-    const updateCallback = ({ data, error }) => {
+    }, [dispatch, showToast, t]);
+    const updateCallback = useCallback(({ data, error }) => {
+        var _a;
         const isCreated = isCreatedOrUpdated(data);
         if (error) {
             showToast(isCreated ? t("messagesCreateFailed") : t("messagesUpdateFailed"), TOAST_VARIANT.ERROR);
@@ -149,11 +188,11 @@ export const useFamilyModule = () => {
         if (data) {
             showToast(t("messagesSaveSuccess"), TOAST_VARIANT.SUCCESS);
             invalidateFamiliesCache();
-            listFetchNow();
+            (_a = listFetchNowRef.current) === null || _a === void 0 ? void 0 : _a.call(listFetchNowRef);
             resetFormAndCloseDrawer();
         }
-    };
-    const byIdCallback = ({ data, error }) => {
+    }, [showToast, t, resetFormAndCloseDrawer]);
+    const byIdCallback = useCallback(({ data, error }) => {
         if (error) {
             showToast(t("messagesDetailsFetchFailed"), TOAST_VARIANT.ERROR);
             return;
@@ -177,8 +216,9 @@ export const useFamilyModule = () => {
                 },
             });
         }
-    };
-    const deleteCallback = ({ data, error }) => {
+    }, [dispatch, showToast, t, setField]);
+    const deleteCallback = useCallback(({ data, error }) => {
+        var _a;
         if (error) {
             showToast(t("messagesDeleteFailed"), TOAST_VARIANT.ERROR);
             return;
@@ -186,13 +226,13 @@ export const useFamilyModule = () => {
         if (data) {
             showToast(t("messagesDeleteSuccess"), TOAST_VARIANT.SUCCESS);
             invalidateFamiliesCache();
-            listFetchNow();
+            (_a = listFetchNowRef.current) === null || _a === void 0 ? void 0 : _a.call(listFetchNowRef);
         }
-    };
-    // ============================================================================
-    // API HOOKS
-    // ============================================================================
-    const { listFetchNow, listLoading, updateFetchNow, updateLoading, byIdFetchNow, deleteFetchNow, deleteLoading, byIdLoading, } = useModuleEntityV2({
+    }, [showToast, t]);
+    // ==========================================================================
+    // 1.4.5 API HOOKS
+    // ==========================================================================
+    const { byIdFetchNow, byIdLoading, deleteFetchNow, deleteLoading, listFetchNow, listLoading, updateFetchNow, updateLoading, } = useModuleEntityV2({
         byIdCallback,
         byIdParams,
         deleteCallback,
@@ -210,35 +250,9 @@ export const useFamilyModule = () => {
             "x-api-token": process.env.NEXT_PUBLIC_API_KEY,
         },
     });
-    // ============================================================================
-    // UTILITIES
-    // ============================================================================
-    const showToast = useCallback((message, variant) => {
-        generateThemeToast({ description: message, variant });
-    }, []);
-    const resetFormAndCloseDrawer = useCallback(() => {
-        dispatch({
-            type: FAMILY_ACTION_TYPES.SET_ERRORS,
-            payload: { errors: {} },
-        });
-        dispatch({
-            type: FAMILY_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
-            payload: { disabled: false },
-        });
-        dispatch({
-            type: FAMILY_ACTION_TYPES.SET_DRAWER,
-            payload: { drawer: null },
-        });
-    }, [dispatch]);
-    const setField = useCallback((key, value) => {
-        dispatch({
-            type: FAMILY_ACTION_TYPES.SET_INPUT_FIELD,
-            payload: { key, value: value === null ? undefined : value },
-        });
-    }, [dispatch]);
-    // ============================================================================
-    // HANDLERS
-    // ============================================================================
+    // ==========================================================================
+    // 1.4.6 HANDLERS
+    // ==========================================================================
     const handleChange = useCallback((field, value) => {
         dispatch({
             type: FAMILY_ACTION_TYPES.SET_ERRORS,
@@ -250,18 +264,6 @@ export const useFamilyModule = () => {
         });
         setField(field, value);
     }, [setField, dispatch]);
-    const handlePageChange = useCallback((page) => {
-        dispatch({
-            type: FAMILY_ACTION_TYPES.SET_CURRENT_PAGE,
-            payload: { currentPage: page },
-        });
-    }, [dispatch]);
-    const handlePageLimitChange = useCallback((limit) => {
-        dispatch({
-            type: FAMILY_ACTION_TYPES.SET_PAGE_LIMIT,
-            payload: { pageLimit: limit },
-        });
-    }, [dispatch]);
     const handleCloseDrawer = useCallback(() => {
         resetFormAndCloseDrawer();
     }, [resetFormAndCloseDrawer]);
@@ -304,10 +306,17 @@ export const useFamilyModule = () => {
             payload: { drawer: FAMILY_DRAWER.MORE_ACTIONS_DRAWER },
         });
     }, [dispatch]);
-    const clearFilters = useCallback(() => {
+    const handlePageChange = useCallback((page) => {
         dispatch({
-            type: FAMILY_ACTION_TYPES.SET_FILTERS,
-            payload: { filters: { filterEnabled: undefined } },
+            type: FAMILY_ACTION_TYPES.SET_CURRENT_PAGE,
+            payload: { currentPage: page },
+        });
+    }, [dispatch]);
+    const handlePageLimitChange = useCallback((_k, value) => {
+        const val = Object.assign({}, value);
+        dispatch({
+            type: FAMILY_ACTION_TYPES.SET_PAGE_LIMIT,
+            payload: { pageLimit: Number(val.option) },
         });
         dispatch({
             type: FAMILY_ACTION_TYPES.SET_CURRENT_PAGE,
@@ -320,6 +329,33 @@ export const useFamilyModule = () => {
             payload: { searchQuery: query },
         });
     }, [dispatch]);
+    const clearSearch = useCallback(() => {
+        dispatch({
+            type: FAMILY_ACTION_TYPES.SET_SEARCH_QUERY,
+            payload: { searchQuery: "" },
+        });
+    }, [dispatch]);
+    const applyFilters = useCallback(() => {
+        dispatch({
+            type: FAMILY_ACTION_TYPES.SET_CURRENT_PAGE,
+            payload: { currentPage: 1 },
+        });
+        listFetchNow();
+        handleCloseDrawer();
+    }, [dispatch, listFetchNow, handleCloseDrawer]);
+    const clearFilters = useCallback(() => {
+        dispatch({
+            type: FAMILY_ACTION_TYPES.SET_FILTERS,
+            payload: { filters: { filterEnabled: undefined } },
+        });
+        dispatch({
+            type: FAMILY_ACTION_TYPES.SET_CURRENT_PAGE,
+            payload: { currentPage: 1 },
+        });
+    }, [dispatch]);
+    // ==========================================================================
+    // 1.4.7 NETWORK ACTIONS
+    // ==========================================================================
     const handleSubmit = useCallback(() => {
         dispatch({
             type: FAMILY_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
@@ -346,14 +382,9 @@ export const useFamilyModule = () => {
             },
         });
     }, [dispatch, updateParams, t, showToast, updateFetchNow]);
-    const applyFilters = useCallback(() => {
-        dispatch({
-            type: FAMILY_ACTION_TYPES.SET_CURRENT_PAGE,
-            payload: { currentPage: 1 },
-        });
-        listFetchNow();
-        handleCloseDrawer();
-    }, [dispatch, listFetchNow, handleCloseDrawer]);
+    // ==========================================================================
+    // 1.4.8 HEADER & ROW ACTIONS
+    // ==========================================================================
     const headerActions = useMemo(() => [
         {
             enabled: false,
@@ -393,9 +424,9 @@ export const useFamilyModule = () => {
             icon: Pencil,
         },
     ], [handleView, handleEdit, t]);
-    // ============================================================================
-    // EFFECTS
-    // ============================================================================
+    // ==========================================================================
+    // 1.4.9 EFFECTS
+    // ==========================================================================
     useEffect(() => {
         var _a;
         if (!((_a = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _a === void 0 ? void 0 : _a.id))
@@ -415,15 +446,16 @@ export const useFamilyModule = () => {
             }
         })();
     }, [listParams, (_b = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _b === void 0 ? void 0 : _b.id, dispatch, showToast, t]);
-    // ============================================================================
-    // RETURN
-    // ============================================================================
-    return {
-        state,
-        dispatch,
-        applyFilters,
+    useEffect(() => {
+        listFetchNowRef.current = listFetchNow;
+    });
+    // ==========================================================================
+    // 1.4.10 RETURN
+    // ==========================================================================
+    return Object.assign(Object.assign({}, context), { applyFilters,
         byIdLoading,
         clearFilters,
+        clearSearch,
         deleteLoading,
         handleChange,
         handleCloseDrawer,
@@ -438,8 +470,8 @@ export const useFamilyModule = () => {
         handleSubmit,
         handleView,
         headerActions,
+        listFetchNow,
         listLoading,
         rowActions,
-        updateLoading,
-    };
+        updateLoading });
 };

package/base-modules/family/page.d.ts

@@ -8,6 +8,9 @@
  *     component type produced by createGenericModulePage never changes at
  *     runtime, preventing the infinite-remount re-render loop)
  *   - permission guard
+ *
+ * Exported utilities:
+ * - `FamilyPage` — root component that wraps with FamilyProvider
  */
 import { FC } from "react";
 import { USER_ROLE } from "../../type";

package/base-modules/family/page.js

@@ -1,5 +1,3 @@
-"use client";
-import { jsx as _jsx } from "react/jsx-runtime";
 /**
  * Family Page Component
  *
@@ -10,7 +8,12 @@ import { jsx as _jsx } from "react/jsx-runtime";
  *     component type produced by createGenericModulePage never changes at
  *     runtime, preventing the infinite-remount re-render loop)
  *   - permission guard
+ *
+ * Exported utilities:
+ * - `FamilyPage` — root component that wraps with FamilyProvider
  */
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
 import { useMemo } from "react";
 import { COMPONENT_TYPE } from "@appcorp/shadcn/components/enhanced-table";
 import { createGenericModulePage, } from "@react-pakistan/util-functions/factory/generic-component-factory";
@@ -74,15 +77,11 @@ const createFamilyConfig = ({ cancelLabel, dispatch, drawerTitle, labelActions,
 // STABLE PAGE COMPONENT (created once, outside render)
 // ============================================================================
 const GenericFamilyPage = createGenericModulePage();
-// ============================================================================
-// INNER PAGE (requires FamilyProvider context)
-// ============================================================================
 const FamilyPageInner = (props) => {
     const context = useFamilyModule();
     // Memoize config creation - destructure props to avoid object reference changes
     const familyConfig = useMemo(() => createFamilyConfig({
         dispatch: context.dispatch,
-        drawer: context.state.drawer,
         cancelLabel: props.cancelLabel,
         drawerTitle: props.drawerTitle,
         labelActions: props.labelActions,
@@ -98,7 +97,6 @@ const FamilyPageInner = (props) => {
         tableTitle: props.tableTitle,
     }), [
         context.dispatch,
-        context.state.drawer,
         props.cancelLabel,
         props.drawerTitle,
         props.labelActions,
@@ -122,4 +120,7 @@ const FamilyPageInner = (props) => {
     }
     return (_jsx("div", { className: "p-4", children: _jsx(GenericFamilyPage, { overrideConfig: familyConfig, context: context, tableBodyCols: tableBodyCols }) }));
 };
+// ============================================================================
+// PAGE EXPORTS
+// ============================================================================
 export const FamilyPage = (props) => (_jsx(FamilyProvider, { children: _jsx(FamilyPageInner, Object.assign({}, props)) }));

package/base-modules/family-member/context.d.ts

@@ -1,5 +1,5 @@
 import { FamilyMemberBE } from "../../type";
-import { type RowAction } from "@appcorp/shadcn/components/enhanced-table";
+import { type RowAction, type TableRow } from "@appcorp/shadcn/components/enhanced-table";
 export declare const FAMILY_MEMBER_DRAWER: {
     readonly FILTER_DRAWER: string;
     readonly FORM_DRAWER: string;
@@ -160,19 +160,20 @@ export declare const useFamilyMemberModule: () => {
     applyFilters: () => void;
     byIdLoading: boolean;
     clearFilters: () => void;
+    clearSearch: () => void;
     deleteLoading: boolean;
     handleChange: (key: string, value: string | number | boolean | Date | undefined | null) => void;
     handleCloseDrawer: () => void;
     handleCreate: () => void;
-    handleDelete: (row?: unknown) => void;
-    handleEdit: (row?: unknown) => void;
+    handleDelete: (row?: TableRow) => void;
+    handleEdit: (row?: TableRow) => void;
     handleFilters: () => void;
     handleMoreActions: () => void;
     handlePageChange: (page: number) => void;
-    handlePageLimitChange: (limit: number) => void;
+    handlePageLimitChange: (_k: string, value: object) => void;
     handleSearch: (query: string) => void;
     handleSubmit: () => void;
-    handleView: (row?: unknown) => void;
+    handleView: (row?: TableRow) => void;
     headerActions: {
         enabled: boolean;
         handleOnClick: () => void;
@@ -180,6 +181,7 @@ export declare const useFamilyMemberModule: () => {
         order: number;
         icon: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
     }[];
+    listFetchNow: (url?: string, config?: import("@react-pakistan/util-functions/hooks/use-fetch").FetchConfig) => void;
     listLoading: boolean;
     rowActions: RowAction[];
     updateLoading: boolean;