@feedmepos/mf-hrm-portal 2.2.5-dev → 2.2.5-dev.10

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

@@ -0,0 +1,82 @@
+import type { CoverageSegment } from '../types';
+import type { ScheduleBoardApi } from './useScheduleBoard';
+import type { ScheduleDemandApi } from './useScheduleDemand';
+import type { ScheduleAssignApi } from './useScheduleAssign';
+export interface ScheduleGapActions {
+    /** Open the shift editor on a brand new shift for this day and these hours. */
+    addShift: (dayIdx: number, position: string, start: string, end: string) => void;
+}
+export declare function useScheduleGapPopover(board: ScheduleBoardApi, demand: ScheduleDemandApi, assign: ScheduleAssignApi, actions: ScheduleGapActions): {
+    state: {
+        open: boolean;
+        pinned: boolean;
+        peek: boolean;
+        wide: boolean;
+        left: number;
+        top: number;
+    };
+    ctx: import("vue").Ref<{
+        from: number;
+        to: number;
+        required: number;
+        scheduled: number;
+        short: number;
+        over: number;
+        roles: {
+            position: string;
+            n: number;
+            required: number;
+            got: number;
+            short: number;
+        }[];
+        anyReq: number;
+        anyGot: number;
+        none: boolean;
+        dayIdx: number;
+    } | null, (CoverageSegment & {
+        dayIdx: number;
+    }) | {
+        from: number;
+        to: number;
+        required: number;
+        scheduled: number;
+        short: number;
+        over: number;
+        roles: {
+            position: string;
+            n: number;
+            required: number;
+            got: number;
+            short: number;
+        }[];
+        anyReq: number;
+        anyGot: number;
+        none: boolean;
+        dayIdx: number;
+    } | null>;
+    view: import("vue").ComputedRef<{
+        crew: number;
+        peak: number;
+        when: string;
+        day: string;
+        none: boolean;
+        required: number;
+        scheduled: number;
+        short: number;
+        over: number;
+        missing: {
+            short: number;
+            position: string;
+        }[];
+        missingNote: string;
+    } | null>;
+    segEnter: (dayIdx: number, from: number, to: number, anchor: HTMLElement) => void;
+    segLeave: () => void;
+    hold: () => void;
+    segClick: (dayIdx: number, from: number, to: number, anchor: HTMLElement) => void;
+    segFocus: (dayIdx: number, from: number, to: number, anchor: HTMLElement) => void;
+    addShift: () => void;
+    suggestStaffing: () => void;
+    close: () => void;
+};
+export type ScheduleGapPopoverApi = ReturnType<typeof useScheduleGapPopover>;

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

@@ -0,0 +1,70 @@
+import type { LeaveSlot } from '../types';
+import type { ScheduleBoardApi } from './useScheduleBoard';
+/** What a day off can be booked as. "Rest Day" leads: it is the most-used reason a day is not
+ * worked. */
+export declare const LEAVE_REASONS: string[];
+/** The type the menu's plain "Leave" row books. */
+export declare const DEFAULT_LEAVE_REASON = "Annual Leave";
+export type ScheduleLeaveMode = 'all' | 'am' | 'pm' | 'custom';
+export interface ScheduleLeaveState {
+    open: boolean;
+    empId: number | null;
+    dayIdx: number | null;
+    /** Booking a new record, rather than editing one that is already on the day. */
+    isNew: boolean;
+    reason: string;
+    mode: ScheduleLeaveMode;
+    /** The hours when mode is 'custom'. */
+    from: string;
+    to: string;
+}
+/** The leave editor — V6.2's "Book leave" dialog: a reason, how much of the day it covers, and
+ * what that does to the person's availability. Opened from the add popup's Rest Day / Leave rows
+ * (booking) and from an existing leave card (editing, or approving a pending request). */
+export declare function useScheduleLeave(board: ScheduleBoardApi): {
+    state: {
+        open: boolean;
+        empId: number | null;
+        dayIdx: number | null;
+        isNew: boolean;
+        reason: string;
+        mode: ScheduleLeaveMode;
+        from: string;
+        to: string;
+    };
+    employee: import("vue").ComputedRef<import("../types").Employee | undefined>;
+    activeSlot: import("vue").ComputedRef<LeaveSlot | null>;
+    options: import("vue").ComputedRef<({
+        hrs: string;
+        mode: "custom";
+        name: "Specific hours";
+    } | {
+        hrs: string;
+        mode: "all";
+        name: "All day";
+    } | {
+        hrs: string;
+        mode: "am";
+        name: "Morning";
+    } | {
+        hrs: string;
+        mode: "pm";
+        name: "Afternoon";
+    })[]>;
+    span: import("vue").ComputedRef<{
+        from: string;
+        to: string;
+        hours: number;
+    }>;
+    valid: import("vue").ComputedRef<boolean>;
+    dayLabel: import("vue").ComputedRef<string>;
+    hoursText: import("vue").ComputedRef<string>;
+    coverText: import("vue").ComputedRef<string>;
+    openFor: (empId: number, dayIdx: number, reason?: string | null) => void;
+    close: () => void;
+    save: () => void;
+    approve: () => void;
+    reject: () => void;
+    remove: () => void;
+};
+export type ScheduleLeaveApi = ReturnType<typeof useScheduleLeave>;

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

@@ -0,0 +1,15 @@
+import type { ScheduleBoardApi } from './useScheduleBoard';
+export interface ScheduleCoverageBadge {
+    position: string;
+    required: number;
+    scheduled: number;
+    short: boolean;
+}
+/** Coverage badges for a day's header card — required vs. scheduled headcount per
+ * position, from the single active shift template's coverage matrix. */
+export declare function useScheduleLegend(board: ScheduleBoardApi): {
+    coveragePositions: import("vue").ComputedRef<string[]>;
+    coverageForDay: (dayIdx: number) => ScheduleCoverageBadge[];
+    dayIsShort: (dayIdx: number) => boolean;
+    dayCardTitle: (dayIdx: number) => string;
+};

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

@@ -0,0 +1,35 @@
+import type { ScheduleBoardApi } from './useScheduleBoard';
+import type { ScheduleAreaBoardApi } from './useScheduleAreaBoard';
+export type ScheduleLegendKey = 'empty' | 'draft' | 'pub' | 'open' | 'warn' | 'ot' | 'leave';
+export interface ScheduleLegendItem {
+    key: ScheduleLegendKey;
+    count: number;
+    label: string;
+    /** The warnings figure is the one worth acting on, so it renders as a control that
+     * cycles the grid through each conflict — see jumpToConflict(). */
+    action: boolean;
+    title?: string;
+}
+interface ScheduleConflictRef {
+    empId: number;
+    dayIdx: number;
+    name: string;
+}
+export interface ScheduleLegendBarOptions {
+    /** Toast for the conflict cycle — "Conflict 2 of 5 · Nadia, Wed". */
+    onJump?: (message: string) => void;
+}
+/** The footer legend under the scheduler: every state a card can be in, counted off the
+ * same records the grid renders. Ported from the mockup's renderLegend(). Every figure is
+ * scoped to the days currently on screen, except warnings — which counts the whole week, so
+ * the number stays stable while jumpToConflict() pages through days one at a time (the
+ * mockup's conflictCount() is likewise whole-data rather than span-scoped).
+ *
+ * Distinct from useScheduleLegend, which is the day header's coverage badges. */
+export declare function useScheduleLegendBar(board: ScheduleBoardApi, areaBoard: ScheduleAreaBoardApi, opts?: ScheduleLegendBarOptions): {
+    items: import("vue").ComputedRef<ScheduleLegendItem[]>;
+    conflicts: import("vue").ComputedRef<ScheduleConflictRef[]>;
+    jumpToConflict: () => void;
+};
+export type ScheduleLegendBarApi = ReturnType<typeof useScheduleLegendBar>;
+export {};