ubk.erp.webpack 1.4.1 → 1.4.3

package/README.md

@@ -562,9 +562,9 @@ const LibraryPage = ({ token }) => {
 import { AddStaff } from "ubk.erp.webpack";
 
 const AddStaffPage = ({ token }) => {
-  const handleFinished = () => {
+  const handleFinished = (rec) => {
     // Optionally refresh staff list or show a notification
-    console.log("Staff created successfully");
+    console.log("Staff created successfully",rec);
   };
 
   return <AddStaff token={token} onFinished={handleFinished} />;
@@ -602,7 +602,65 @@ const AddStaffPage = ({ token }) => {
 | `Shift` | Shift master. |
 | `StaffDailyAttendance` | Daily attendance report + print. |
 | `PayrollReceiptDetails` | Payroll receipt details (page/component). |
-| `StaffWizard` | Multi-step staff creation/edit wizard with `onReturn` callback per step. |
+| `StaffWizard` | Multi-step staff creation/edit wizard with `onStepComplete` callback per step. |
+| `StaffDirectory` | Staff list with search, edit (drawer), and delete/deactivate actions. |
+
+# 📚 StaffDirectory — Edit & Delete Callbacks
+
+`StaffDirectory` supports several callback props for integration with parent components:
+
+## Props
+
+| Prop | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| `token` | `string` | Yes | Authentication token for API requests. |
+| `onNavigate` | `(action: string, record: object) => void` | No | Called when the Edit button is clicked. Receives `("staff-edit", record)`. If provided, the parent handles navigation. |
+| `onFinished` | `(res: any) => void` | No | Called after the wizard (edit drawer) completes successfully. |
+| `onDelete` | `(payload: DeletePayload) => void` | No | Called after a staff member is deactivated. |
+
+## DeletePayload Shape
+
+```ts
+{
+  id: string | number;
+  record: object;       // The full staff record
+  response: any;        // API response from the delete/deactivate endpoint
+}
+```
+
+## Behavior
+
+- Clicking the **Edit** button: if `onNavigate` is provided, it calls `onNavigate("staff-edit", record)`. Otherwise, opens an inline edit drawer with `StaffWizard` in `mode="edit"`.
+- Clicking **Delete/Deactivate**: sends a deactivate request to the API. On success, refreshes the list and calls `onDelete({ id, record, response })`.
+- `onFinished` fires after the edit wizard completes successfully, allowing the parent to refresh its own data.
+
+## Usage
+
+```jsx
+import { StaffDirectory } from "ubk.erp.webpack";
+
+const StaffPage = ({ token }) => {
+
+
+  const handleFinished = (res) => {
+    console.log("Staff updated:", res);
+    // Refresh external data
+  };
+
+  const handleDelete = (payload) => {
+    console.log("Staff deactivated:", payload);
+  };
+
+  return (
+    <StaffDirectory
+      token={token}
+     
+      onFinished={handleFinished}
+      onDelete={handleDelete}
+    />
+  );
+};
+```
 
 # 📚 StaffWizard — Return Callback
 
@@ -615,34 +673,31 @@ const AddStaffPage = ({ token }) => {
 | `token` | `string` | Yes | Authentication token for API requests. |
 | `mode` | `'add' \| 'edit'` | No | Determines whether basic info is edited or created. Default: `"add"`. |
 | `staffId` | `string` | No | Staff ID when editing; ignored when `mode="add"`. |
+| `onStepComplete` | `(payload: object) => void` | No | Called after **every** step's successful save. |
 | `onFinished` | `() => void` | No | Called after the final (Payroll) step completes. |
-| `onReturn` | `(payload: object) => void` | No | Called after **every** step's successful save. |
 
 ## Payload Shape
 
-The `onReturn` callback receives an object:
+The `onStepComplete` callback receives an object:
 
 ```ts
 {
   step: "basic" | "experience" | "payroll";
-  staffId: string | null;
   data?: object;   // Step-specific data
-  result?: object;  // API response (experience step only)
 }
 ```
 
 | Step | `data` contents |
 | :--- | :--- |
-| `"basic"` | `{ roleValue, departmentValue, designationValue, genderValue, shiftValue, dob, doj, file }` |
-| `"experience"` | `rows` array (each row: `{ name, from, to, image }`) |
-| `"payroll"` | `{ staffType, salaryType, amount, basicPay, declaration }` |
+| `"basic"` | `{ staffId, basic }` from Step1's `onSubmitted` |
+| `"experience"` | `{ experience, result }` from Step2's `onSubmitted` |
+| `"payroll"` | `{ payroll, result }` from Step3's `onSubmitted` |
 
 ## Behavior
 
-- `onReturn` is only called when the step's API responds with `Status === "Success"`.
+- `onStepComplete` is only called when the step's API responds with `Status === "Success"`.
 - It is **not** called if the API returns `Failed` or throws an error.
-- The callback allows the parent to react to each step's completion (e.g., refresh data, update UI state).
-- `onFinished` is still called at the end (after the Payroll step) for backward compatibility.
+- `onFinished` is called after the Payroll step completes (and also calls `onStepComplete` for the `"payroll"` step).
 
 ## Usage
 
@@ -650,7 +705,7 @@ The `onReturn` callback receives an object:
 import { StaffWizard } from "ubk.erp.webpack";
 
 const StaffPage = ({ token }) => {
-  const handleReturn = (payload) => {
+  const handleStepComplete = (payload) => {
     console.log("Step completed:", payload.step, payload);
   };
 
@@ -662,7 +717,7 @@ const StaffPage = ({ token }) => {
     <StaffWizard
       token={token}
       mode="add"
-      onReturn={handleReturn}
+      onStepComplete={handleStepComplete}
       onFinished={handleFinished}
     />
   );
@@ -732,6 +787,84 @@ const CommunicatePage = ({ token }) => {
 };
 ```
 
+### Exam
+
+| Component | Description |
+| :--- | :--- |
+|
+| `Exam` | Create an exam schedule. |
+| `ExamList` | Exam schedule list. |
+| `ExamEdit` | Edit an exam schedule. |
+| `ExamDetails` | Exam schedule details. |
+| `ExamLink` | Exam links. |
+| `ExamType` | Exam type list. |
+| `Grade` | Grade master — add, edit and delete grades with a mark range (Mark From / Mark To) and remark. |
+| `CoScholasticAreaGrade` | Co-scholastic grade master — add, edit and delete grades with a remark (no mark range). |
+| `ExamSetting` | Per exam/class report card settings: class-teacher signature per section, Exam I/C signature, report card title, marksheet issue date, promoted-to and abbreviations. |
+| `ExamInstruction` | Pick an exam and edit its instructions in a rich-text editor (bold, italic, underline, lists). Saved as HTML and printed on the admit card. |
+| `Assessment` | Assessment management. |
+| `AssignMarks` | Enter exam marks for students. |
+| `CoScholasticAreaMarks` | Search by Class / Section / Exam / Co-Scholastic Category, then enter a grade per student per skill and save. |
+| `StudentResult` | Search by Class / Section / Exam to see each student's marks, percentage, marks-entry progress, meetings and attendance. Edit remarks, meeting dates, attendance and result per student. |
+| `MarksReport` | Marks report. |
+| `AdmitCardSetting` | Admit card settings (photo, room no, subject list, exam time, invigilator and Exam I/C signature toggles). |
+| `AdmitPrint` | Search by Class / Section / Exam and print admit cards using one of three templates. The class's assigned template is preselected. |
+| `RoomManagment` | Add/delete exam rooms, and assign rooms with roll-number ranges per section for a class and exam. |
+
+### Using the Exam Module
+
+```jsx
+import {
+  Grade,
+  CoScholasticAreaGrade,
+  ExamSetting,
+  ExamInstruction,
+  CoScholasticAreaMarks,
+  StudentResult,
+  AdmitPrint,
+  RoomManagment,
+} from "ubk.erp.webpack";
+
+const ExamPage = ({ token }) => {
+  return (
+    <>
+      <Grade token={token} />
+      <CoScholasticAreaGrade token={token} />
+      <ExamSetting token={token} />
+      <ExamInstruction token={token} />
+      <CoScholasticAreaMarks token={token} />
+      <StudentResult token={token} />
+      <AdmitPrint token={token} />
+      <RoomManagment token={token} />
+    </>
+  );
+};
+```
+
+**Notes:**
+- `AdmitPrint` reads the session name from `localStorage.academy_session` (templates 2 and 3). Set it in the host app, otherwise the session shows as blank / `-`.
+- `AdmitPrint` requests `per_page=10` students per search.
+- The **View Result** button in `StudentResult` navigates to `/ExamDashboard/SingleResult?id=…&exam_id=…`, which is not part of this library yet.
+- `RoomManagment` is spelled as in the original project (no "e" after "g").
+
+**Endpoint overrides** — each Exam endpoint has a built-in default and can be overridden with a `VITE_*` variable in `.env`, for example:
+
+| Variable | Default |
+| :--- | :--- |
+| `VITE_GRADE_TABLE_URL` / `_ADD_URL` / `_EDIT_URL` / `_DELETE_URL` | `/api/exam/exam/getgradeTable`, `addGrade`, `editGradec`, `deleteGrade` |
+| `VITE_COSCHOLASTIC_GRADE_TABLE_URL` / `_ADD_URL` / `_EDIT_URL` / `_DELETE_URL` | `/api/exam/exam/getgradeTableCoScholastic`, `addGradeCoScholastic`, `editGradeCoScholastic`, `deleteGradeCoScholastic` |
+| `VITE_COSCHOLASTIC_GRADE_DROPDOWN_URL` | `/api/exam/exam/gradeDropdownCoScholastic` |
+| `VITE_COSCHOLASTIC_ASSIGN_MARKS_URL` | `/api/exam/exam/assignCoscholasticMarks` |
+| `VITE_COSCHOLASTIC_CATEGORY_DROPDOWN_URL` | `/api/branchapi/academy/getscholasticCategoryByClassId` |
+| `VITE_EXAM_SETTING_UPLOAD_FILE_URL` | `api/SuperAdmin/uploadFile` (signature uploads, saved to `schoolFile`) |
+| `VITE_EXAM_ROOM_LIST_URL` / `_DELETE_URL` | `/api/exam/Exam/listClassRoom`, `/api/exam/Exam/removeClassRoom` |
+| `VITE_EXAM_ROOM_ADD_URL` | `/api/exam/exam/addClassRoom` |
+| `VITE_EXAM_ROOM_ASSIGNED_LIST_URL` | `/api/exam/Exam/getClassRoomdata` |
+| `VITE_EXAM_ROOM_ASSIGN_URL` / `_REMOVE_URL` | `/api/exam/exam/assignClassRoom`, `/api/exam/exam/remove_exam_class_room` |
+| `VITE_EXAM_ROOM_DROPDOWN_URL` / `_EXAM_DROPDOWN_URL` | `/api/exam/exam/roomDropdown`, `examdropdown_new` |
+
+See `src/Layout/Exam/Services/examsService.js` for the full list.
+
 
 
 ## 🛠️ Development

package/dist/Layout/Exam/AdmitPrint.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+export default AdmitPrint;
+declare function AdmitPrint({ token }: {
+    token: any;
+}): React.JSX.Element;

package/dist/Layout/Exam/CoScholasticAreaGrade.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+export default CoScholasticAreaGrade;
+declare function CoScholasticAreaGrade({ token }: {
+    token: any;
+}): React.JSX.Element;

package/dist/Layout/Exam/Components/AdmitCardTemplates.d.ts

@@ -0,0 +1,18 @@
+import { default as React } from 'react';
+export function templateOptionAdmit(): {
+    label: string;
+    value: string;
+}[];
+export function buildTemplateContext(data: any): {
+    academy_session: any;
+    exam_details: any;
+    receipt_info: any;
+    general_setting: any;
+    students: any;
+    settings: any;
+};
+export default AdmitCardTemplate;
+declare function AdmitCardTemplate({ templateId, data }: {
+    templateId: any;
+    data: any;
+}): React.JSX.Element;

package/dist/Layout/Exam/Components/AssignClassRoomEditor.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+export default AssignClassRoomEditor;
+/**
+ * Add mode (no rowData): pick class + exam, then fill roll ranges per section.
+ * Update mode (rowData = an assigned-room record): locked to that record's class, exam and section.
+ * Calls onSubmit(formData) with class_id, exam_id, the row arrays and added/updated/deleted JSON.
+ */
+declare function AssignClassRoomEditor({ token, rowData, onSubmit }: {
+    token: any;
+    rowData: any;
+    onSubmit: any;
+}): React.JSX.Element;

package/dist/Layout/Exam/Grade.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+export default Grade;
+declare function Grade({ token }: {
+    token: any;
+}): React.JSX.Element;

package/dist/Layout/Exam/Pages/AdmitPrintPage.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+export default AdmitPrintPage;
+declare function AdmitPrintPage({ token }: {
+    token: any;
+}): React.JSX.Element;

package/dist/Layout/Exam/Pages/CoScholasticAreaGradePage.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+export default CoScholasticAreaGradePage;
+declare function CoScholasticAreaGradePage({ token }: {
+    token: any;
+}): React.JSX.Element;

package/dist/Layout/Exam/Pages/GradePage.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+export default GradePage;
+declare function GradePage({ token }: {
+    token: any;
+}): React.JSX.Element;

package/dist/Layout/Exam/Services/examsService.d.ts

@@ -6,11 +6,31 @@ export namespace endpoints {
         let edit: any;
         let remove: any;
     }
-    export namespace examSchedule {
+    export namespace grade {
+        let table_1: any;
+        export { table_1 as table };
         let add_1: any;
         export { add_1 as add };
         let edit_1: any;
         export { edit_1 as edit };
+        let remove_1: any;
+        export { remove_1 as remove };
+    }
+    export namespace coScholasticGrade {
+        let table_2: any;
+        export { table_2 as table };
+        let add_2: any;
+        export { add_2 as add };
+        let edit_2: any;
+        export { edit_2 as edit };
+        let remove_2: any;
+        export { remove_2 as remove };
+    }
+    export namespace examSchedule {
+        let add_3: any;
+        export { add_3 as add };
+        let edit_3: any;
+        export { edit_3 as edit };
         export let getById: any;
         export let list: any;
         let dropdown_1: any;
@@ -29,17 +49,17 @@ export namespace endpoints {
         export let update: any;
     }
     export namespace examSetting {
-        let table_1: any;
-        export { table_1 as table };
-        let add_2: any;
-        export { add_2 as add };
+        let table_3: any;
+        export { table_3 as table };
+        let add_4: any;
+        export { add_4 as add };
         export let uploadSignature: any;
         export let typeByExamId: any;
         export let assignMarksheetClass: any;
     }
     export namespace assessment {
-        let table_2: any;
-        export { table_2 as table };
+        let table_4: any;
+        export { table_4 as table };
         let dropdown_3: any;
         export { dropdown_3 as dropdown };
         let _delete: any;
@@ -62,6 +82,7 @@ export namespace endpoints {
         let getGradeTable: any;
         let getGradeTableCoScholastic: any;
         let getAdmitCard: any;
+        let subjectDropdown: any;
     }
     export namespace admitCardSetting {
         let get_1: any;
@@ -72,14 +93,18 @@ export namespace endpoints {
     export namespace roomManagement {
         let list_1: any;
         export { list_1 as list };
-        let remove_1: any;
-        export { remove_1 as remove };
+        export let removeRoom: any;
+        export let assignedList: any;
+        export let examDropdown: any;
+        let remove_3: any;
+        export { remove_3 as remove };
         export let assign: any;
-        let add_3: any;
-        export { add_3 as add };
+        let add_5: any;
+        export { add_5 as add };
         export let roomDropdown: any;
     }
-    export let examDropdown: any;
+    let examDropdown_1: any;
+    export { examDropdown_1 as examDropdown };
     export let examDropdownInstruction: any;
     export namespace observation {
         let dropdown_4: any;
@@ -89,19 +114,24 @@ export namespace endpoints {
         export let deleteType: any;
         export let editType: any;
         export let addType: any;
-        let add_4: any;
-        export { add_4 as add };
+        let add_6: any;
+        export { add_6 as add };
     }
     export let coscholasticCategoryDropdown: any;
+    export namespace coScholasticMarks {
+        export let gradeDropdown: any;
+        let assign_1: any;
+        export { assign_1 as assign };
+    }
     export namespace templateType {
         let get_2: any;
         export { get_2 as get };
         export let assignClassDropdown: any;
         export let assignTable: any;
-        let assign_1: any;
-        export { assign_1 as assign };
-        let remove_2: any;
-        export { remove_2 as remove };
+        let assign_2: any;
+        export { assign_2 as assign };
+        let remove_4: any;
+        export { remove_4 as remove };
     }
     export let classSubjectDropdown: any;
     export let sectionDropdown: any;

package/dist/Layout/Exam/hooks.d.ts

@@ -1,35 +1,10 @@
-export function useExamTypeDropdown(token: any): {
-    isLoading: boolean;
-    error: any;
-    examTypeOptions: any;
-};
-export function useExamDropdown(classId: any, token: any): {
-    isLoading: boolean;
-    error: any;
-    examList: any;
-    mutate: import('swr').KeyedMutator<any>;
-};
-export function useExamSchedule(token: any): {
-    isLoading: boolean;
-    error: any;
-    examSchedule: any;
-    mutate: import('swr').KeyedMutator<any>;
-};
-export function useAssessmentTable(token: any): {
-    isLoading: boolean;
-    error: any;
-    assessmentData: any;
-    mutate: import('swr').KeyedMutator<any>;
-};
-export function useExamSettingTable(page: any, perPage: any, token: any): {
-    isLoading: boolean;
-    error: any;
-    examSettingData: any;
-    mutate: import('swr').KeyedMutator<any>;
-};
-export function useStudentResult(token: any): {
-    isLoading: boolean;
-    error: any;
-    studentResultData: any;
-    mutate: import('swr').KeyedMutator<any>;
-};
+export function useSubmit(handler: any): (boolean | ((...args: any[]) => Promise<any>))[];
+export function usePaginatedFetcher(): {
+    fetchAllPagesWithProgress: (tableData: any, exam_id: any, onProgress: any, token: any) => Promise<any[]>;
+    isMutating: boolean;
+};
+declare namespace _default {
+    export { useSubmit };
+    export { usePaginatedFetcher };
+}
+export default _default;

package/dist/Layout/Exam/index.d.ts

@@ -2,6 +2,9 @@ export { default as StudentResult } from './StudentResult';
 export { default as Exam } from './Exam';
 export { default as ExamList } from './ExamList';
 export { default as ExamType } from './ExamType';
+export { default as Grade } from './Grade';
+export { default as AdmitPrint } from './AdmitPrint';
+export { default as CoScholasticAreaGrade } from './CoScholasticAreaGrade';
 export { default as ExamSetting } from './ExamSetting';
 export { default as Assessment } from './Assessment';
 export { default as ExamInstruction } from './ExamInstruction';

package/dist/Layout/HumanResource/StaffDirectory/Pages/StaffDirectoryPage.d.ts

@@ -1,6 +1,8 @@
 import { default as React } from 'react';
 export default StaffDirectoryPage;
-declare function StaffDirectoryPage({ token, onNavigate }: {
+declare function StaffDirectoryPage({ token, onNavigate, onFinished, onDelete, }: {
     token: any;
     onNavigate: any;
+    onFinished: any;
+    onDelete: any;
 }): React.JSX.Element;

package/dist/Layout/HumanResource/StaffDirectory/StaffDirectory.d.ts

@@ -1,6 +1,8 @@
 import { default as React } from 'react';
 export default StaffDirectory;
-declare function StaffDirectory({ token, onNavigate }: {
+declare function StaffDirectory({ token, onNavigate, onFinished, onDelete }: {
     token: any;
     onNavigate: any;
+    onFinished: any;
+    onDelete: any;
 }): React.JSX.Element;

package/dist/Layout/HumanResource/StaffWizard/StaffWizard copy.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+export default StaffWizard;
+declare function StaffWizard({ token, mode, staffId: staffIdProp, onFinished }: {
+    token: any;
+    mode?: string | undefined;
+    staffId: any;
+    onFinished: any;
+}): React.JSX.Element;

package/dist/Layout/HumanResource/StaffWizard/StaffWizard.d.ts

@@ -1,8 +1,9 @@
 import { default as React } from 'react';
 export default StaffWizard;
-declare function StaffWizard({ token, mode, staffId: staffIdProp, onFinished }: {
+declare function StaffWizard({ token, mode, staffId: staffIdProp, onStepComplete, onFinished, }: {
     token: any;
     mode?: string | undefined;
     staffId: any;
+    onStepComplete: any;
     onFinished: any;
 }): React.JSX.Element;