@feedmepos/mf-hrm-portal 2.2.5 → 2.3.0-dev.2

package/dist/src/views/scheduling/composables/useScheduleBoard.d.ts

@@ -0,0 +1,539 @@
+import type { Employee, OpenShift, PendingChange, ScheduleStatusInfo, ScheduleVersion, ScheduleVersionSnapshot, Section, WorkSlot } from '../types';
+import { RANGE_LEN } from './schedule-week-cache';
+import { contractCapFor, isGenuineSplitGroup, isLeaveSlot, isPartTime, isoDateKey, isWorkSlot, overContract, positionKeyOf, workSlotsOf } from './schedule-board-helpers';
+export { contractCapFor, isGenuineSplitGroup, isLeaveSlot, isPartTime, isoDateKey, isWorkSlot, overContract, positionKeyOf, workSlotsOf, };
+export { RANGE_LEN };
+export type ScheduleGranularity = 'day' | 'week';
+export declare function useScheduleBoard(handlers?: {
+    onPersistError?: (message: string) => void;
+}): {
+    dayNote: (dayIdx: number) => import("../types").ScheduleDayNote | null;
+    setDayNote: (dayIdx: number, title: string, desc: string) => void;
+    clearDayNote: (dayIdx: number) => void;
+    isStandingClosedWeekday: (dayIdx: number) => boolean;
+    holidayName: (dayIdx: number) => string | null;
+    holidayIsAuto: (dayIdx: number) => boolean;
+    isPublicHoliday: (dayIdx: number) => boolean;
+    holidayRateApplies: (dayIdx: number) => boolean;
+    setHolidayNormal: (dayIdx: number, toNormal: boolean) => void;
+    setPublicHoliday: (dayIdx: number, on: boolean) => void;
+    otRateOn: (dayIdx: number) => number;
+    regularRateOn: (dayIdx: number) => number;
+    isHoliday: (dayIdx: number) => boolean;
+    employees: import("vue").Ref<{
+        id: number;
+        sourceId: string;
+        name: string;
+        employmentType: "FULLTIME" | "PARTTIME";
+        role: string;
+        initials: string;
+        color: string;
+        weekHours: number;
+        pct: number;
+        contractHours?: number | undefined;
+        rate: number;
+        positions: string[];
+        shifts: ({
+            start: string;
+            end: string;
+            role: string;
+            status: import("../types").ShiftStatus;
+            clock?: {
+                in: string | null;
+                out: string | null;
+                status: "on-time" | "late" | "early-out" | "absent";
+            } | undefined;
+            conflict?: boolean | undefined;
+            conflictReason?: string | undefined;
+            openId?: number | undefined;
+            breakMins?: number | undefined;
+            breaks?: ({
+                type: "DURATION";
+                minutes: number;
+                breakPayType: "PAID" | "UNPAID";
+            } | {
+                type: "TIME_RANGE";
+                startTime: string;
+                endTime: string;
+                breakPayType: "PAID" | "UNPAID";
+            })[] | undefined;
+            assignmentId?: string | undefined;
+            updatedAt?: string | undefined;
+            splitGroupId?: string | undefined;
+        } | {
+            timeOff: "approved" | "pending";
+            requestId?: string | undefined;
+            type?: "OFF_DAY" | "LEAVE" | undefined;
+            leaveType?: "ANNUAL" | "MEDICAL" | "EMERGENCY" | "UNPAID" | undefined;
+            reason: string;
+            half?: boolean | undefined;
+            halfPart?: "AM" | "PM" | undefined;
+            from?: string | undefined;
+            to?: string | undefined;
+            appliedOn?: string | undefined;
+            note?: string | undefined;
+            cert?: {
+                name: string;
+                size: string;
+            } | null | undefined;
+            bal?: {
+                type: string;
+                entitled: number;
+                used: number;
+            } | undefined;
+        } | {
+            start: string;
+            end: string;
+            role: string;
+            status: import("../types").ShiftStatus;
+            clock?: {
+                in: string | null;
+                out: string | null;
+                status: "on-time" | "late" | "early-out" | "absent";
+            } | undefined;
+            conflict?: boolean | undefined;
+            conflictReason?: string | undefined;
+            openId?: number | undefined;
+            breakMins?: number | undefined;
+            breaks?: ({
+                type: "DURATION";
+                minutes: number;
+                breakPayType: "PAID" | "UNPAID";
+            } | {
+                type: "TIME_RANGE";
+                startTime: string;
+                endTime: string;
+                breakPayType: "PAID" | "UNPAID";
+            })[] | undefined;
+            assignmentId?: string | undefined;
+            updatedAt?: string | undefined;
+            splitGroupId?: string | undefined;
+        }[] | null)[];
+        remarks: {
+            author: string;
+            date: string;
+            type: "note" | "warning" | "praise";
+            text: string;
+        }[];
+        section: string;
+        compGroup?: string | undefined;
+        mobile?: string | undefined;
+        dial?: string | undefined;
+        locations?: string[] | undefined;
+        payBasis?: "hourly" | "monthly" | undefined;
+        payAmount?: number | undefined;
+        maxHours?: number | undefined;
+        maxOtHours?: number | undefined;
+        minHours?: number | undefined;
+        otAfterDaily?: number | undefined;
+        preferences?: string[] | undefined;
+        seniority?: "senior" | "junior" | "" | undefined;
+        availDays?: boolean[] | undefined;
+        availHours?: {
+            from: string;
+            to: string;
+        }[] | undefined;
+        passcode?: string | undefined;
+        masterUser?: boolean | undefined;
+    }[], Employee[] | {
+        id: number;
+        sourceId: string;
+        name: string;
+        employmentType: "FULLTIME" | "PARTTIME";
+        role: string;
+        initials: string;
+        color: string;
+        weekHours: number;
+        pct: number;
+        contractHours?: number | undefined;
+        rate: number;
+        positions: string[];
+        shifts: ({
+            start: string;
+            end: string;
+            role: string;
+            status: import("../types").ShiftStatus;
+            clock?: {
+                in: string | null;
+                out: string | null;
+                status: "on-time" | "late" | "early-out" | "absent";
+            } | undefined;
+            conflict?: boolean | undefined;
+            conflictReason?: string | undefined;
+            openId?: number | undefined;
+            breakMins?: number | undefined;
+            breaks?: ({
+                type: "DURATION";
+                minutes: number;
+                breakPayType: "PAID" | "UNPAID";
+            } | {
+                type: "TIME_RANGE";
+                startTime: string;
+                endTime: string;
+                breakPayType: "PAID" | "UNPAID";
+            })[] | undefined;
+            assignmentId?: string | undefined;
+            updatedAt?: string | undefined;
+            splitGroupId?: string | undefined;
+        } | {
+            timeOff: "approved" | "pending";
+            requestId?: string | undefined;
+            type?: "OFF_DAY" | "LEAVE" | undefined;
+            leaveType?: "ANNUAL" | "MEDICAL" | "EMERGENCY" | "UNPAID" | undefined;
+            reason: string;
+            half?: boolean | undefined;
+            halfPart?: "AM" | "PM" | undefined;
+            from?: string | undefined;
+            to?: string | undefined;
+            appliedOn?: string | undefined;
+            note?: string | undefined;
+            cert?: {
+                name: string;
+                size: string;
+            } | null | undefined;
+            bal?: {
+                type: string;
+                entitled: number;
+                used: number;
+            } | undefined;
+        } | {
+            start: string;
+            end: string;
+            role: string;
+            status: import("../types").ShiftStatus;
+            clock?: {
+                in: string | null;
+                out: string | null;
+                status: "on-time" | "late" | "early-out" | "absent";
+            } | undefined;
+            conflict?: boolean | undefined;
+            conflictReason?: string | undefined;
+            openId?: number | undefined;
+            breakMins?: number | undefined;
+            breaks?: ({
+                type: "DURATION";
+                minutes: number;
+                breakPayType: "PAID" | "UNPAID";
+            } | {
+                type: "TIME_RANGE";
+                startTime: string;
+                endTime: string;
+                breakPayType: "PAID" | "UNPAID";
+            })[] | undefined;
+            assignmentId?: string | undefined;
+            updatedAt?: string | undefined;
+            splitGroupId?: string | undefined;
+        }[] | null)[];
+        remarks: {
+            author: string;
+            date: string;
+            type: "note" | "warning" | "praise";
+            text: string;
+        }[];
+        section: string;
+        compGroup?: string | undefined;
+        mobile?: string | undefined;
+        dial?: string | undefined;
+        locations?: string[] | undefined;
+        payBasis?: "hourly" | "monthly" | undefined;
+        payAmount?: number | undefined;
+        maxHours?: number | undefined;
+        maxOtHours?: number | undefined;
+        minHours?: number | undefined;
+        otAfterDaily?: number | undefined;
+        preferences?: string[] | undefined;
+        seniority?: "senior" | "junior" | "" | undefined;
+        availDays?: boolean[] | undefined;
+        availHours?: {
+            from: string;
+            to: string;
+        }[] | undefined;
+        passcode?: string | undefined;
+        masterUser?: boolean | undefined;
+    }[]>;
+    sections: import("vue").Ref<{
+        id: string;
+        label: string;
+        roles: string[];
+        system?: boolean | undefined;
+    }[], Section[] | {
+        id: string;
+        label: string;
+        roles: string[];
+        system?: boolean | undefined;
+    }[]>;
+    openShifts: import("vue").Ref<{
+        id: number;
+        dayIdx: number;
+        position: string;
+        required: number;
+        filledBy: number | null;
+        sen?: "junior" | "senior" | undefined;
+        empType?: "full" | "part" | undefined;
+        name?: string | undefined;
+        start: string;
+        end: string;
+        breakMins?: number | undefined;
+    }[], OpenShift[] | {
+        id: number;
+        dayIdx: number;
+        position: string;
+        required: number;
+        filledBy: number | null;
+        sen?: "junior" | "senior" | undefined;
+        empType?: "full" | "part" | undefined;
+        name?: string | undefined;
+        start: string;
+        end: string;
+        breakMins?: number | undefined;
+    }[]>;
+    rangeStart: import("vue").Ref<Date, Date>;
+    weekOffset: import("vue").ComputedRef<number>;
+    peekWeek: (offset: number) => import("./schedule-week-cache").WeekBucket;
+    isRecentlySaved: (empId: number, dayIdx: number) => boolean;
+    isWeekLocked: (offset?: number) => boolean;
+    dayLocked: (dayIdx: number) => boolean;
+    pendingChanges: import("vue").Ref<{
+        empId: number;
+        employeeKey: string;
+        dayIdx: number;
+        kind: "add" | "change" | "remove";
+        label: string;
+    }[], PendingChange[] | {
+        empId: number;
+        employeeKey: string;
+        dayIdx: number;
+        kind: "add" | "change" | "remove";
+        label: string;
+    }[]>;
+    unpublishedChanges: import("vue").ComputedRef<PendingChange[]>;
+    persistPublish: (items: Array<{
+        empId: number;
+        dayIdx: number;
+        slot: WorkSlot;
+    }>) => Promise<boolean>;
+    flushAssignmentWrites: () => Promise<void>;
+    recordChange: (empId: number, dayIdx: number, kind: PendingChange["kind"], label: string) => void;
+    scheduleVersions: import("vue").Ref<{
+        v: number;
+        at: Date;
+        by: string;
+        note: string;
+        changeCount: number;
+        staffAffected: number;
+        snapshot: {
+            id: number;
+            name: string;
+            weekHours: number;
+            shifts: ({
+                start: string;
+                end: string;
+                role: string;
+                status: import("../types").ShiftStatus;
+                clock?: {
+                    in: string | null;
+                    out: string | null;
+                    status: "on-time" | "late" | "early-out" | "absent";
+                } | undefined;
+                conflict?: boolean | undefined;
+                conflictReason?: string | undefined;
+                openId?: number | undefined;
+                breakMins?: number | undefined;
+                breaks?: ({
+                    type: "DURATION";
+                    minutes: number;
+                    breakPayType: "PAID" | "UNPAID";
+                } | {
+                    type: "TIME_RANGE";
+                    startTime: string;
+                    endTime: string;
+                    breakPayType: "PAID" | "UNPAID";
+                })[] | undefined;
+                assignmentId?: string | undefined;
+                updatedAt?: string | undefined;
+                splitGroupId?: string | undefined;
+            } | {
+                timeOff: "approved" | "pending";
+                requestId?: string | undefined;
+                type?: "OFF_DAY" | "LEAVE" | undefined;
+                leaveType?: "ANNUAL" | "MEDICAL" | "EMERGENCY" | "UNPAID" | undefined;
+                reason: string;
+                half?: boolean | undefined;
+                halfPart?: "AM" | "PM" | undefined;
+                from?: string | undefined;
+                to?: string | undefined;
+                appliedOn?: string | undefined;
+                note?: string | undefined;
+                cert?: {
+                    name: string;
+                    size: string;
+                } | null | undefined;
+                bal?: {
+                    type: string;
+                    entitled: number;
+                    used: number;
+                } | undefined;
+            } | {
+                start: string;
+                end: string;
+                role: string;
+                status: import("../types").ShiftStatus;
+                clock?: {
+                    in: string | null;
+                    out: string | null;
+                    status: "on-time" | "late" | "early-out" | "absent";
+                } | undefined;
+                conflict?: boolean | undefined;
+                conflictReason?: string | undefined;
+                openId?: number | undefined;
+                breakMins?: number | undefined;
+                breaks?: ({
+                    type: "DURATION";
+                    minutes: number;
+                    breakPayType: "PAID" | "UNPAID";
+                } | {
+                    type: "TIME_RANGE";
+                    startTime: string;
+                    endTime: string;
+                    breakPayType: "PAID" | "UNPAID";
+                })[] | undefined;
+                assignmentId?: string | undefined;
+                updatedAt?: string | undefined;
+                splitGroupId?: string | undefined;
+            }[] | null)[];
+        }[];
+    }[], ScheduleVersion[] | {
+        v: number;
+        at: Date;
+        by: string;
+        note: string;
+        changeCount: number;
+        staffAffected: number;
+        snapshot: {
+            id: number;
+            name: string;
+            weekHours: number;
+            shifts: ({
+                start: string;
+                end: string;
+                role: string;
+                status: import("../types").ShiftStatus;
+                clock?: {
+                    in: string | null;
+                    out: string | null;
+                    status: "on-time" | "late" | "early-out" | "absent";
+                } | undefined;
+                conflict?: boolean | undefined;
+                conflictReason?: string | undefined;
+                openId?: number | undefined;
+                breakMins?: number | undefined;
+                breaks?: ({
+                    type: "DURATION";
+                    minutes: number;
+                    breakPayType: "PAID" | "UNPAID";
+                } | {
+                    type: "TIME_RANGE";
+                    startTime: string;
+                    endTime: string;
+                    breakPayType: "PAID" | "UNPAID";
+                })[] | undefined;
+                assignmentId?: string | undefined;
+                updatedAt?: string | undefined;
+                splitGroupId?: string | undefined;
+            } | {
+                timeOff: "approved" | "pending";
+                requestId?: string | undefined;
+                type?: "OFF_DAY" | "LEAVE" | undefined;
+                leaveType?: "ANNUAL" | "MEDICAL" | "EMERGENCY" | "UNPAID" | undefined;
+                reason: string;
+                half?: boolean | undefined;
+                halfPart?: "AM" | "PM" | undefined;
+                from?: string | undefined;
+                to?: string | undefined;
+                appliedOn?: string | undefined;
+                note?: string | undefined;
+                cert?: {
+                    name: string;
+                    size: string;
+                } | null | undefined;
+                bal?: {
+                    type: string;
+                    entitled: number;
+                    used: number;
+                } | undefined;
+            } | {
+                start: string;
+                end: string;
+                role: string;
+                status: import("../types").ShiftStatus;
+                clock?: {
+                    in: string | null;
+                    out: string | null;
+                    status: "on-time" | "late" | "early-out" | "absent";
+                } | undefined;
+                conflict?: boolean | undefined;
+                conflictReason?: string | undefined;
+                openId?: number | undefined;
+                breakMins?: number | undefined;
+                breaks?: ({
+                    type: "DURATION";
+                    minutes: number;
+                    breakPayType: "PAID" | "UNPAID";
+                } | {
+                    type: "TIME_RANGE";
+                    startTime: string;
+                    endTime: string;
+                    breakPayType: "PAID" | "UNPAID";
+                })[] | undefined;
+                assignmentId?: string | undefined;
+                updatedAt?: string | undefined;
+                splitGroupId?: string | undefined;
+            }[] | null)[];
+        }[];
+    }[]>;
+    lastUpdatedAt: import("vue").Ref<Date | null, Date | null>;
+    lastPublishedAt: import("vue").Ref<Date | null, Date | null>;
+    pushVersion: (note: string, opts?: Partial<ScheduleVersion>) => ScheduleVersion;
+    snapshotSchedule: () => ScheduleVersionSnapshot[];
+    scheduleStatus: import("vue").ComputedRef<ScheduleStatusInfo>;
+    conflictCount: () => number;
+    granularity: import("vue").Ref<ScheduleGranularity, ScheduleGranularity>;
+    focusDayIdx: import("vue").Ref<number, number>;
+    setGranularity: (value: ScheduleGranularity) => void;
+    dayDates: import("vue").ComputedRef<Date[]>;
+    dayLabels: import("vue").ComputedRef<string[]>;
+    visibleDayIndices: import("vue").ComputedRef<number[]>;
+    visibleDays: import("vue").ComputedRef<{
+        dayIdx: number;
+        date: Date;
+    }[]>;
+    rangeLabel: import("vue").ComputedRef<string>;
+    isToday: (dayIdx: number) => boolean;
+    dateKey: (dayIdx: number) => string | null;
+    navigate: (delta: number) => void;
+    goToday: () => void;
+    membersOf: (sectionId: string) => Employee[];
+    sectionCost: (sectionId: string, members?: Employee[]) => number;
+    totalWeeklyCost: import("vue").ComputedRef<number>;
+    employeeById: (id: number) => Employee | undefined;
+    commitShift: (empId: number, dayIdx: number, slot: WorkSlot | WorkSlot[], replaceIndex?: number, replaceCount?: number) => void;
+    commitShiftAt: (offset: number, empId: number, dayIdx: number, slot: WorkSlot | WorkSlot[], replaceIndex?: number, replaceCount?: number) => void;
+    removeShift: (empId: number, dayIdx: number, slotIndex?: number, count?: number) => void;
+    removeShiftAt: (offset: number, empId: number, dayIdx: number, slotIndex?: number, count?: number) => void;
+    employeeShiftsToClear: (empId: number) => number[];
+    clearEmployeeShifts: (empId: number) => {
+        shifts: number;
+    };
+    moveShift: (fromEmpId: number, fromDayIdx: number, toEmpId: number, toDayIdx: number, fromSlotIndex?: number, fromSlotCount?: number) => boolean;
+    swapShifts: (empIdA: number, empIdB: number, dayA: number, dayB?: number, slotIndexA?: number, slotIndexB?: number, slotCountA?: number) => boolean;
+    clearShiftsInRange: () => {
+        shifts: number;
+        open: number;
+        leave: number;
+    };
+    requiredFor: (dayIdx: number, position: string) => number;
+    scheduledFor: (dayIdx: number, position: string) => number;
+    compGroupRate: (name: string | undefined) => number | undefined;
+    UNASSIGNED: string;
+};
+export type ScheduleBoardApi = ReturnType<typeof useScheduleBoard>;

package/dist/src/views/scheduling/composables/useScheduleCellState.d.ts

@@ -0,0 +1,27 @@
+import type { ScheduleBoardApi } from './useScheduleBoard';
+/** Column facts shared by the day header and every `.shift-cell` under it.
+ *
+ * The mockup builds these inline in its cell loop (`cell.className = 'shift-cell' + …`) and
+ * again in its header loop, which is exactly how the two drifted: closing a day painted the
+ * header and left the cells beneath it clean. One helper, both consumers.
+ *
+ * Two of the mockup's cell states are deliberately absent here:
+ *   - `wk-off` — this board has no standing weekly-off pattern to read (same reason
+ *     `otRateOn()` drops the mockup's rest-day case).
+ *   - `peek` / `week-start` — the mockup renders a multi-week horizon, so it has columns
+ *     outside the selected range and interior week boundaries. This board's visible range
+ *     is exactly one week, so neither can ever fire.
+ */
+export declare function isPastDate(date: Date): boolean;
+export declare function isWeekendDate(date: Date): boolean;
+/** Month-edge compares neighbours in the VISIBLE column order, not raw weekday
+ * index — a lone Daily-view column has no on-screen neighbour to differ from. */
+export declare function isMonthEdgeAt(board: ScheduleBoardApi, colIndex: number): boolean;
+export interface ScheduleCellState {
+    locked: boolean;
+    'closed-day': boolean;
+    'month-edge': boolean;
+    past: boolean;
+}
+/** The class object for one grid cell in column `colIndex` (its weekday is `dayIdx`). */
+export declare function cellStateClasses(board: ScheduleBoardApi, dayIdx: number, colIndex: number): ScheduleCellState;

package/dist/src/views/scheduling/composables/useScheduleClashDetection.d.ts

@@ -0,0 +1,28 @@
+export interface ScheduleClashState {
+    open: boolean;
+    message: string;
+    /** Per-call overrides, falling back to the "might conflict" wording every call used before
+     * these existed — only the closed-day confirmation (see SchedulePage's onAddShift/
+     * onOpenDemandSheet) needs its own title and button label so far. */
+    title: string | null;
+    confirmLabel: string | null;
+    onConfirm: (() => void) | null;
+}
+/** Generic Yes/No conflict-confirmation primitive — the mockup's `askClash`/clashModal,
+ * reused across several flows (leave clashes, overlapping shifts, etc). */
+export declare function useScheduleClashDetection(): {
+    state: {
+        open: boolean;
+        message: string;
+        title: string | null;
+        confirmLabel: string | null;
+        onConfirm: (() => void) | null;
+    };
+    ask: (message: string, onConfirm: () => void, opts?: {
+        title?: string;
+        confirmLabel?: string;
+    }) => void;
+    confirm: () => void;
+    close: () => void;
+};
+export type ScheduleClashDetectionApi = ReturnType<typeof useScheduleClashDetection>;

package/dist/src/views/scheduling/composables/useScheduleCloneOutletModal.d.ts

@@ -0,0 +1,21 @@
+import type { ScheduleOutletApi } from './useScheduleOutlet';
+/** "Clone setup to…" on the General page. Copies this outlet's *saved* pay rates — `RULES`,
+ * not the page's draft — to one or more other outlets the manager ticks. Scoped to pay rates
+ * because that is the only outlet-scoped setting this page persists; the mockup's broader
+ * "rules, shifts, coverage and positions" clone lives on pages this one doesn't own. */
+export declare function useScheduleCloneOutletModal(outlet: ScheduleOutletApi, options?: {
+    notify?: (message: string, type?: 'success' | 'error' | 'info') => void;
+}): {
+    open: import("vue").Ref<boolean, boolean>;
+    query: import("vue").Ref<string, string>;
+    selected: import("vue").Ref<Set<string> & Omit<Set<string>, keyof Set<any>>, Set<string> | (Set<string> & Omit<Set<string>, keyof Set<any>>)>;
+    saving: import("vue").Ref<boolean, boolean>;
+    done: import("vue").Ref<number | null, number | null>;
+    sourceLabel: import("vue").ComputedRef<string>;
+    targets: import("vue").ComputedRef<import("../components/ScheduleSelect.vue").ScheduleSelectOption[]>;
+    openModal: () => void;
+    close: () => void;
+    toggle: (id: string) => void;
+    confirm: () => Promise<void>;
+};
+export type ScheduleCloneOutletModalApi = ReturnType<typeof useScheduleCloneOutletModal>;