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

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

@@ -0,0 +1,247 @@
+import type { ScheduleBoardApi } from './useScheduleBoard';
+/** The employee grid's own row list — search-filtered, in the roster's own order.
+ *
+ * Ported from the mockup's getSorted()/EMP_ORDER. The grid's rows are the axis you edit along,
+ * so load-sorting them (the way the area view's staff rail does) meant every assignment moved
+ * that person down the list — the row you just used slid out from under the cursor. The order
+ * seeds from name order and only ever changes when a manager drags a name, so a row stays put
+ * while you work. There is deliberately no "sort by load" control here; that's a staff-rail
+ * feature. */
+export declare function useScheduleRoster(board: ScheduleBoardApi): {
+    search: import("vue").Ref<string, string>;
+    filteredEmployees: import("vue").ComputedRef<{
+        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;
+    }[]>;
+    orderedEmployees: import("vue").ComputedRef<{
+        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;
+    }[]>;
+    order: import("vue").Ref<number[], number[]>;
+    reorder: (draggedId: number, targetId: number, after: boolean) => Promise<void>;
+};
+export type ScheduleRosterApi = ReturnType<typeof useScheduleRoster>;

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

@@ -0,0 +1,35 @@
+export type ScheduleSettingsSection = 'budget' | 'payrates' | 'overtime' | 'notify';
+/** Keep unsupported sections out of the navigation until their API fields exist. */
+export declare const SETTINGS_SECTIONS: {
+    key: ScheduleSettingsSection;
+    label: string;
+}[];
+/** Settings currently supported by the schedule API: pay rates and monthly OT hours. */
+export declare function useScheduleSettings(): {
+    isOpen: import("vue").Ref<boolean, boolean>;
+    activeSection: import("vue").Ref<ScheduleSettingsSection, ScheduleSettingsSection>;
+    draft: {
+        payRate: {
+            NORMAL: {
+                overtime: number;
+            };
+            REST_DAY: {
+                regular: number;
+                overtime: number;
+            };
+            PUBLIC_HOLIDAY: {
+                regular: number;
+                overtime: number;
+            };
+        };
+        otCapHours: number;
+    };
+    dirty: import("vue").ComputedRef<boolean>;
+    loading: import("vue").Ref<boolean, boolean>;
+    load: () => Promise<void>;
+    open: (section?: ScheduleSettingsSection) => void;
+    close: () => boolean;
+    discard: () => void;
+    save: () => Promise<void>;
+};
+export type ScheduleSettingsApi = ReturnType<typeof useScheduleSettings>;

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

@@ -0,0 +1,17 @@
+/** "Set it up" banner — shown while the outlet has not finished scheduling setup, i.e. while
+ * `scheduleSetupCompleted` (schedule-store) is false. Dismissing is a session choice: the banner is cheap enough to see
+ * again on the next visit while the outlet really is unconfigured.
+ *
+ * The welcome dialog shares that same gate, plus its own session dismiss so closing it doesn't
+ * also close the banner. `scheduleSetupCompleted` lands from an async fetch and starts `false`
+ * before that fetch resolves, so gating on it alone would flash the dialog open for an outlet
+ * whose real answer just hasn't arrived yet — `payload` is what distinguishes "not set up" from
+ * "don't know yet": it is only ever non-null once a board fetch for the current outlet has
+ * actually landed. */
+export declare function useScheduleSetupBanner(): {
+    open: import("vue").ComputedRef<boolean>;
+    start: () => void;
+    dismiss: () => Promise<void>;
+    welcomeOpen: import("vue").ComputedRef<boolean>;
+    dismissWelcome: () => void;
+};

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

@@ -0,0 +1,207 @@
+import type { Employee } from '../types';
+import type { ScheduleBoardApi } from './useScheduleBoard';
+export interface ScheduleCardMenuState {
+    open: boolean;
+    empId: number | null;
+    dayIdx: number | null;
+    /** Which period on that day the menu was opened from — the card's own slot index. */
+    slotIndex: number;
+    left: number;
+    top: number;
+}
+export interface ScheduleChangeState {
+    open: boolean;
+    empId: number | null;
+    dayIdx: number | null;
+    slotIndex: number;
+}
+export interface ScheduleSwapState {
+    open: boolean;
+    empId: number | null;
+    dayIdx: number | null;
+    /** Which period of `dayIdx` is actually being traded — a sibling shift on that same day
+     * stays with its owner untouched. */
+    slotIndex: number;
+    /** How many periods starting at `slotIndex` go together — a genuine split's own period
+     * count, so dragging its one merged card trades the whole shift; 1 for anything else. */
+    slotCount: number;
+    /** Set when the swap came from dropping one shift on another: that shift is the only choice. */
+    preset: {
+        empId: number;
+        dayIdx: number;
+    } | null;
+}
+/** The shift card's "⋯" menu (Change employee / Swap shifts / Edit / Remove), plus the two
+ * dialogs it opens that the rest of Phase 1 didn't need: handing a shift to somebody else,
+ * and trading two people's shifts on the same day. Both skip the mockup's OT/pay-band cost
+ * preview and hard/soft override tiers — this board has no per-person pay bands to price
+ * against, so a candidate is either qualified-and-free or it isn't offered at all. */
+export declare function useScheduleShiftActions(board: ScheduleBoardApi, options?: {
+    onToast?: (message: string, type?: 'success' | 'error' | 'info') => void;
+}): {
+    menu: {
+        open: boolean;
+        empId: number | null;
+        dayIdx: number | null;
+        slotIndex: number;
+        left: number;
+        top: number;
+    };
+    openMenu: (empId: number, dayIdx: number, anchor: HTMLElement, slotIndex?: number) => void;
+    closeMenu: () => void;
+    change: {
+        open: boolean;
+        empId: number | null;
+        dayIdx: number | null;
+        slotIndex: number;
+    };
+    changeSlot: import("vue").ComputedRef<import("../types").WorkSlot[]>;
+    changeCandidates: import("vue").ComputedRef<{
+        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;
+    }[]>;
+    openChange: (empId: number, dayIdx: number, slotIndex?: number) => void;
+    closeChange: () => void;
+    confirmChange: (toId: number) => void;
+    swap: {
+        open: boolean;
+        empId: number | null;
+        dayIdx: number | null;
+        slotIndex: number;
+        slotCount: number;
+        preset: {
+            empId: number;
+            dayIdx: number;
+        } | null;
+    };
+    swapSlot: import("vue").ComputedRef<import("../types").WorkSlot[]>;
+    swapCandidates: import("vue").ComputedRef<{
+        emp: Employee;
+        dayIdx: number;
+        slot: import("../types").WorkSlot[];
+        soft: string | null;
+    }[]>;
+    swapPreset: import("vue").ComputedRef<{
+        emp: Employee;
+        dayIdx: number;
+        slot: import("../types").WorkSlot[];
+        soft: string | null;
+    } | null>;
+    openSwap: (empId: number, dayIdx: number, preset?: ScheduleSwapState["preset"], slotIndex?: number, slotCount?: number) => void;
+    closeSwap: () => void;
+    confirmSwap: (toEmpId: number, toDayIdx: number) => void;
+    removeShift: (empId: number, dayIdx: number, slotIndex?: number) => void;
+};
+export type ScheduleShiftActionsApi = ReturnType<typeof useScheduleShiftActions>;

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

@@ -0,0 +1,62 @@
+import type { WorkSlot } from '../types';
+import { type ScheduleBreakChoice, type ScheduleShiftSegment } from './schedule-shift-time';
+export interface ScheduleHeadcountRole {
+    position: string;
+    count: number;
+    sen: '' | 'senior' | 'junior';
+}
+export declare function useScheduleShiftDraft(): {
+    open: import("vue").Ref<boolean, boolean>;
+    dayIdx: import("vue").Ref<number | null, number | null>;
+    empId: import("vue").Ref<number | null, number | null>;
+    originalEmpId: import("vue").Ref<number | null, number | null>;
+    editingOpenShiftId: import("vue").Ref<number | null, number | null>;
+    isNew: import("vue").Ref<boolean, boolean>;
+    originalSlotIndex: import("vue").Ref<number, number>;
+    originalSlotCount: import("vue").Ref<number, number>;
+    originalSplitGroupId: import("vue").Ref<string | undefined, string | undefined>;
+    originalDayHadContent: import("vue").Ref<boolean, boolean>;
+    name: import("vue").Ref<string, string>;
+    segments: import("vue").Ref<{
+        start: string;
+        end: string;
+    }[], ScheduleShiftSegment[] | {
+        start: string;
+        end: string;
+    }[]>;
+    role: import("vue").Ref<string, string>;
+    required: import("vue").Ref<number, number>;
+    sen: import("vue").Ref<"" | "senior" | "junior", "" | "senior" | "junior">;
+    empType: import("vue").Ref<"" | "full" | "part", "" | "full" | "part">;
+    roles: import("vue").Ref<{
+        position: string;
+        count: number;
+        sen: "" | "senior" | "junior";
+    }[], ScheduleHeadcountRole[] | {
+        position: string;
+        count: number;
+        sen: "" | "senior" | "junior";
+    }[]>;
+    breakChoice: import("vue").Ref<ScheduleBreakChoice, ScheduleBreakChoice>;
+    breakCustomMins: import("vue").Ref<number, number>;
+    breakCustomUnit: import("vue").Ref<"mins" | "hrs", "mins" | "hrs">;
+    breakMode: import("vue").Ref<"time" | "duration", "time" | "duration">;
+    breakStartTime: import("vue").Ref<string, string>;
+    breakEndTime: import("vue").Ref<string, string>;
+    repeatDays: import("vue").Ref<boolean[], boolean[]>;
+    gapNote: import("vue").Ref<string | null, string | null>;
+    conflictNote: import("vue").Ref<string | null, string | null>;
+    grantSkill: import("vue").Ref<boolean, boolean>;
+    unassignMode: import("vue").Ref<boolean, boolean>;
+    resetCommon: (day: number) => void;
+    applyNormalizedBreak: (minutes: number | undefined) => void;
+    applyPersistedBreaks: (breaks: WorkSlot["breaks"], fallbackMins: number | undefined) => void;
+    resolvedBreakMins: () => number | undefined;
+    resolvedBreaks: () => WorkSlot["breaks"];
+    buildDraftSlot: () => WorkSlot | WorkSlot[];
+    close: () => void;
+    removeSegment: (index: number) => void;
+    addRole: () => void;
+    removeRole: (index: number) => void;
+    segmentHoursOf: (segment: ScheduleShiftSegment) => number;
+};

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

@@ -0,0 +1,17 @@
+import type { ComputedRef } from 'vue';
+import type { ScheduleBoardApi } from './useScheduleBoard';
+import { useScheduleShiftDraft } from './useScheduleShiftDraft';
+type ShiftDraft = ReturnType<typeof useScheduleShiftDraft>;
+interface UseScheduleShiftPersistenceOptions {
+    draft: ShiftDraft;
+    saveDisabled: ComputedRef<boolean>;
+    showGrantSkill: ComputedRef<boolean>;
+    onToast?: (message: string, type?: 'success' | 'error' | 'info') => void;
+}
+/** Mutations for the shift popover. Draft editing stays separate so the UI can preview and
+ * validate without owning board writes. */
+export declare function useScheduleShiftPersistence(board: ScheduleBoardApi, options: UseScheduleShiftPersistenceOptions): {
+    save: () => void;
+    remove: () => void;
+};
+export {};