@feedmepos/mf-hrm-portal 2.3.2-dev → 2.3.2-dev.3

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

@@ -0,0 +1,25 @@
+import type { ScheduleSelectOption } from '../components/ScheduleSelect.vue';
+/** Which outlet the board is scheduling, and the picker that changes it.
+ *
+ * On entry the outlet last picked in the schedule wins, remembered per business in localStorage.
+ * The host shell (mf-common) resets its own `currentRestaurant` to the first manageable outlet
+ * and rewrites `?restaurantId=` on every reload, so neither the URL nor the shell's selection
+ * can carry the user's pick across a refresh. Only when nothing was ever picked here does the
+ * shell's selection decide, so arriving from elsewhere in the portal lands on the outlet that
+ * was already being looked at. Failing that it falls back to the first outlet in the business,
+ * which is better than an empty board. The picker offers only restaurants the user can manage.
+ *
+ * Switching from the picker saves the pick and writes the new id back into `?restaurantId=` too,
+ * via `router.replace`, not a navigation, so it does not reload the page or add a history entry.
+ * The picker already re-fetches everything the new outlet needs (see switchTo below); this just
+ * keeps the address bar honest about which one is on screen. */
+export declare function useScheduleOutlet(): {
+    options: import("vue").ComputedRef<ScheduleSelectOption[]>;
+    ready: import("vue").Ref<boolean, boolean>;
+    outletId: import("vue").Ref<string, string>;
+    resolve: () => Promise<string>;
+    resolveOutlet: () => Promise<string>;
+    switchTo: (restaurantId: string, weekStart: Date) => Promise<boolean>;
+    setBeforeSwitch: (handler: (restaurantId: string) => boolean | Promise<boolean>) => void;
+};
+export type ScheduleOutletApi = ReturnType<typeof useScheduleOutlet>;

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

@@ -0,0 +1,18 @@
+import type { ScheduleBoardApi } from './useScheduleBoard';
+import type { ScheduleAutoScheduleApi } from './useScheduleAutoSchedule';
+import type { SchedulePublishApi } from './useSchedulePublish';
+interface UseSchedulePageActionsOptions {
+    board: ScheduleBoardApi;
+    autoSchedule: ScheduleAutoScheduleApi;
+    publish: SchedulePublishApi;
+    notify: (message: string, type: 'info' | 'success') => void;
+}
+export declare function useSchedulePageActions(options: UseSchedulePageActionsOptions): {
+    comingSoon: () => void;
+    onSchedStatusClick: () => void;
+    onApplyProposals: (count: number) => void;
+    onApplyAndPublishProposals: (count: number) => Promise<void>;
+    onProposalDragStart: (id: number, event: DragEvent) => void;
+    onScroll: (delta: number) => void;
+};
+export {};

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

@@ -0,0 +1,9 @@
+import type { ScheduleBoardApi } from './useScheduleBoard';
+import type { ScheduleDemandApi } from './useScheduleDemand';
+import type { ScheduleOutletApi } from './useScheduleOutlet';
+/** Owns SchedulePage's data bootstrap and loading lifecycle, separate from rendering concerns. */
+export declare function useSchedulePageBootstrap(board: ScheduleBoardApi, demand: ScheduleDemandApi, outlet: ScheduleOutletApi): {
+    booting: import("vue").Ref<boolean, boolean>;
+    showSkeleton: import("vue").ComputedRef<boolean>;
+    applyStoredDemand: () => void;
+};

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

@@ -0,0 +1,21 @@
+import type { ScheduleBoardApi } from './useScheduleBoard';
+import type { ScheduleClashDetectionApi } from './useScheduleClashDetection';
+import type { ScheduleDemandApi } from './useScheduleDemand';
+import type { ScheduleAddPickApi } from './useScheduleAddPick';
+import type { ScheduleShiftPopoverApi } from './useScheduleShiftPopover';
+import type { ScheduleDemandSheetApi } from './useScheduleDemandSheet';
+interface UseSchedulePageCellActionsOptions {
+    board: ScheduleBoardApi;
+    clash: ScheduleClashDetectionApi;
+    demand: ScheduleDemandApi;
+    addPick: ScheduleAddPickApi;
+    popover: ScheduleShiftPopoverApi;
+    demandSheet: ScheduleDemandSheetApi;
+}
+export declare function useSchedulePageCellActions(options: UseSchedulePageCellActionsOptions): {
+    dayHasAnyShift: (dayIdx: number) => boolean;
+    onAddShift: (empId: number, dayIdx: number, anchor: HTMLElement) => void;
+    onEditShift: (empId: number, dayIdx: number, slotIndex?: number) => void;
+    onOpenDemandSheet: (dayIdx: number) => void;
+};
+export {};

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

@@ -0,0 +1,20 @@
+import type { ScheduleBoardApi } from './useScheduleBoard';
+import type { ScheduleClashDetectionApi } from './useScheduleClashDetection';
+import type { ScheduleDragDropApi } from './useScheduleDragDrop';
+import type { ScheduleShiftActionsApi } from './useScheduleShiftActions';
+import type { ScheduleAutoScheduleApi } from './useScheduleAutoSchedule';
+interface UseSchedulePageCellDropOptions {
+    board: ScheduleBoardApi;
+    autoSchedule: ScheduleAutoScheduleApi;
+    dragDrop: ScheduleDragDropApi;
+    shiftActions: ScheduleShiftActionsApi;
+    clash: ScheduleClashDetectionApi;
+    dayHasAnyShift: (dayIdx: number) => boolean;
+    notify: (message: string, type: 'error') => void;
+}
+export declare function useSchedulePageCellDrop(options: UseSchedulePageCellDropOptions): {
+    onCellDrop: (empId: number, dayIdx: number, event: DragEvent, targetSlotIndex?: number, kind?: "employee" | "position") => void;
+    confirmPositionSwap: (toEmpId: number, toDayIdx: number, onConfirm: () => void) => void;
+    confirmPositionDrop: (targetDayIdx: number, onConfirm: () => void) => void;
+};
+export {};

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

@@ -0,0 +1,33 @@
+import type { ScheduleBoardApi } from './useScheduleBoard';
+import type { ScheduleDemandApi } from './useScheduleDemand';
+export type ClearKind = 'both' | 'shifts' | 'demand';
+export declare const CLEAR_COPY: Record<ClearKind, {
+    title: string;
+    message: string;
+    confirm: string;
+}>;
+/** i18n keys behind each confirm dialog — `CLEAR_COPY` above is the English fallback kept for
+ * existing callers; prefer the translated `clearCopy` the composable returns. */
+export declare const CLEAR_COPY_KEYS: Record<ClearKind, {
+    title: string;
+    message: string;
+    confirm: string;
+}>;
+type Snackbar = {
+    open: (options: {
+        message: string;
+        type: 'error' | 'info' | 'success';
+    }) => void;
+};
+export declare function useSchedulePageClearActions(board: ScheduleBoardApi, demand: ScheduleDemandApi, snackbar: Snackbar): {
+    clearKind: import("vue").Ref<ClearKind | null, ClearKind | null>;
+    clearCopy: import("vue").ComputedRef<{
+        title: string;
+        message: string;
+        confirm: string;
+    } | null>;
+    clearing: import("vue").Ref<boolean, boolean>;
+    onConfirmClear: () => Promise<void>;
+};
+export type SchedulePageClearActionsApi = ReturnType<typeof useSchedulePageClearActions>;
+export {};

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

@@ -0,0 +1,22 @@
+import type { ScheduleBoardApi } from './useScheduleBoard';
+import type { Ref } from 'vue';
+import { useScheduleEmployeeProfile } from './useScheduleEmployeeProfile';
+import type { ScheduleAddEmployeeApi } from './useScheduleAddEmployee';
+import type { ScheduleClashDetectionApi } from './useScheduleClashDetection';
+type ScheduleEmployeeProfileApi = ReturnType<typeof useScheduleEmployeeProfile>;
+interface UseSchedulePageEmployeeActionsOptions {
+    board: ScheduleBoardApi;
+    employeeProfile: ScheduleEmployeeProfileApi;
+    addEmployee: ScheduleAddEmployeeApi;
+    removeEmployeeId: Ref<number | null>;
+    clash: ScheduleClashDetectionApi;
+    notify: (message: string, type: 'error' | 'info' | 'success') => void;
+}
+export declare function useSchedulePageEmployeeActions(options: UseSchedulePageEmployeeActionsOptions): {
+    onOpenEmployeeMenu: (empId: number) => void;
+    onEditEmployee: () => void;
+    onClearAllShifts: (empId: number) => void;
+    onRemoveEmployee: () => void;
+    onConfirmRemoveEmployee: () => Promise<void>;
+};
+export {};

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

@@ -0,0 +1,21 @@
+import { ref } from 'vue';
+import type { ScheduleAddPickApi } from './useScheduleAddPick';
+import type { ScheduleDayNoteApi } from './useScheduleDayNote';
+import type { ScheduleGapPopoverApi } from './useScheduleGapPopover';
+import type { ScheduleShiftActionsApi } from './useScheduleShiftActions';
+import type { ScheduleTimePickerApi } from './useScheduleTimePicker';
+export type ScheduleTopbarMenu = 'actions' | 'export';
+export interface ScheduleTopbarApi {
+    openMenu: ReturnType<typeof ref<ScheduleTopbarMenu | null>>;
+    toggleMenu: (id: ScheduleTopbarMenu) => void;
+    closeMenus: () => void;
+}
+export declare function useSchedulePageOverlays(apis: {
+    dayNote: ScheduleDayNoteApi;
+    gap: ScheduleGapPopoverApi;
+    timePicker: ScheduleTimePickerApi;
+    addPick: ScheduleAddPickApi;
+    shiftActions: ScheduleShiftActionsApi;
+}): {
+    topbar: ScheduleTopbarApi;
+};

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

@@ -0,0 +1,19 @@
+import { type ComputedRef, type Ref } from 'vue';
+export interface SchedulePdfCanvas {
+    canvas: HTMLCanvasElement;
+}
+export interface SchedulePdfExportOptions {
+    subtitle: ComputedRef<string>;
+    title: ComputedRef<string>;
+    buildCanvas: () => SchedulePdfCanvas | null;
+    buildSheetImage: (onReady: () => void) => void;
+    jpgPreviewOpen: Ref<boolean>;
+    releaseSheetImage: () => void;
+}
+export declare function useSchedulePdfExport(options: SchedulePdfExportOptions): {
+    previewOpen: Ref<boolean, boolean>;
+    barMeta: ComputedRef<string>;
+    openPreview: () => void;
+    closePreview: () => void;
+    printNow: () => void;
+};

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

@@ -0,0 +1,55 @@
+export interface PositionModalPerson {
+    employeeId: string;
+    name: string;
+    initials: string;
+    /** Positions they already hold, main first — the row's second line. */
+    held: string[];
+    heldPositionIds: string[];
+}
+export interface PositionModalDone {
+    name: string;
+    assigned: number;
+    failed: number;
+}
+/** The "Add position" popup: a name, plus who on this outlet's roster can work it.
+ *
+ * Saving creates the (business-wide) position, then adds it to each ticked person's profile —
+ * as their main position when they have none yet, otherwise as one more they are trained in.
+ * The profile write replaces `secondaryPositions` wholesale, so a person's existing ones are
+ * sent back with the new one rather than being dropped. */
+export declare function useSchedulePositionModal(onCreated?: (positionName: string) => void, options?: {
+    notify?: (message: string, type?: 'success' | 'error' | 'info') => void;
+}): {
+    open: import("vue").Ref<boolean, boolean>;
+    name: import("vue").Ref<string, string>;
+    search: import("vue").Ref<string, string>;
+    picks: Record<string, boolean>;
+    saving: import("vue").Ref<boolean, boolean>;
+    error: import("vue").Ref<string | null, string | null>;
+    done: import("vue").Ref<{
+        name: string;
+        assigned: number;
+        failed: number;
+    } | null, PositionModalDone | {
+        name: string;
+        assigned: number;
+        failed: number;
+    } | null>;
+    nameError: import("vue").Ref<boolean, boolean>;
+    people: import("vue").ComputedRef<PositionModalPerson[]>;
+    visible: import("vue").ComputedRef<PositionModalPerson[]>;
+    pickedIds: import("vue").ComputedRef<string[]>;
+    allPicked: import("vue").ComputedRef<boolean>;
+    nameTaken: import("vue").ComputedRef<boolean>;
+    canSave: import("vue").ComputedRef<boolean>;
+    editingId: import("vue").Ref<string | null, string | null>;
+    openNew: () => void;
+    openEdit: (id: string, currentName: string) => void;
+    close: () => void;
+    toggle: (employeeId: string) => void;
+    toggleAll: () => void;
+    save: () => Promise<boolean>;
+    saveAndAnother: () => Promise<void>;
+    another: () => void;
+};
+export type SchedulePositionModalApi = ReturnType<typeof useSchedulePositionModal>;

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

@@ -0,0 +1,35 @@
+export interface SchedulePositionRow {
+    id: string;
+    name: string;
+}
+export declare function useSchedulePositions(options?: {
+    notify?: (message: string, type?: 'success' | 'error' | 'info') => void;
+    deferWrites?: boolean;
+}): {
+    positions: import("vue").Ref<{
+        id: string;
+        name: string;
+    }[], SchedulePositionRow[] | {
+        id: string;
+        name: string;
+    }[]>;
+    pendingCreates: string[];
+    pendingDeletes: Set<string>;
+    count: import("vue").ComputedRef<number>;
+    isAdding: import("vue").Ref<boolean, boolean>;
+    newName: import("vue").Ref<string, string>;
+    pendingDeleteId: import("vue").Ref<string | null, string | null>;
+    saving: import("vue").Ref<boolean, boolean>;
+    error: import("vue").Ref<string | null, string | null>;
+    usageCountFor: (positionId: string) => number;
+    startAdd: () => void;
+    cancelAdd: () => void;
+    confirmAdd: () => Promise<void>;
+    askDelete: (id: string) => void;
+    cancelDelete: () => void;
+    confirmDelete: (id: string) => Promise<void>;
+    commitCreates: () => Promise<void>;
+    commitDeletes: () => Promise<void>;
+    discardPending: () => void;
+};
+export type SchedulePositionsApi = ReturnType<typeof useSchedulePositions>;

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

@@ -0,0 +1,127 @@
+import type { ScheduleBoardApi } from './useScheduleBoard';
+import type { ScheduleVersion } from '../types';
+export interface VersionDiffRow {
+    name: string;
+    day: string;
+    kind: 'add' | 'rem' | 'chg';
+    from: string | null;
+    to: string | null;
+}
+/** The mockup's Publish modal (openPublish/renderPublish/confirmPublish) — draft vs. published
+ * stamps, a conflict-acknowledgement gate, the pending-change list, and per-version diffing
+ * against the previous version. The mockup's WhatsApp/push/email notify-channel block is not
+ * ported: it depends on per-employee notification-preference data that doesn't exist anywhere
+ * in this mock model, and building it would mean inventing a whole notification-preferences
+ * concept with no other consumer — publish here just publishes. */
+export declare function useSchedulePublish(board: ScheduleBoardApi): {
+    isOpen: import("vue").Ref<boolean, boolean>;
+    pubAcked: import("vue").Ref<boolean, boolean>;
+    showAllVersions: import("vue").Ref<boolean, boolean>;
+    expandedVersion: import("vue").Ref<number | null, number | null>;
+    open: () => void;
+    close: () => void;
+    conflicts: import("vue").ComputedRef<number>;
+    confirmDisabled: import("vue").ComputedRef<boolean>;
+    publishing: import("vue").Ref<boolean, boolean>;
+    visibleVersions: import("vue").ComputedRef<{
+        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;
+                positionId?: string | undefined;
+                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;
+                positionId?: string | undefined;
+                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)[];
+        }[];
+    }[]>;
+    toggleAllVersions: () => void;
+    toggleVersionDiff: (v: number) => void;
+    diffFor: (version: ScheduleVersion) => VersionDiffRow[];
+    confirm: () => Promise<void>;
+    shareOpen: import("vue").Ref<boolean, boolean>;
+    shareVersion: import("vue").Ref<number | null, number | null>;
+    shareStaffAffected: import("vue").Ref<number, number>;
+    showShareCompletion: (changeCount: number, staffAffected: number) => void;
+    closeShare: () => void;
+};
+export type SchedulePublishApi = ReturnType<typeof useSchedulePublish>;

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

@@ -0,0 +1,11 @@
+import type { WorkSlot } from '../types';
+export interface SchedulePublishPersistenceOptions {
+    recoverPersistFailure: (error: unknown, fallback: string) => Promise<void>;
+}
+export declare function useSchedulePublishPersistence(options: SchedulePublishPersistenceOptions): {
+    persistPublish: (items: Array<{
+        empId: number;
+        dayIdx: number;
+        slot: WorkSlot;
+    }>) => Promise<boolean>;
+};

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

@@ -0,0 +1,27 @@
+import type { ScheduleBoardApi } from './useScheduleBoard';
+/** Range-calendar popover behind the topbar's date label — month grid + Today/This
+ * week/Next week presets, matching the mockup's range calendar. */
+export declare function useScheduleRangeCalendar(board: ScheduleBoardApi): {
+    open: import("vue").Ref<boolean, boolean>;
+    pos: {
+        left: number;
+        top: number;
+    };
+    toggle: (anchor?: HTMLElement) => void;
+    close: () => void;
+    cursorMonth: import("vue").Ref<Date, Date>;
+    shiftMonth: (delta: number) => void;
+    monthLabel: import("vue").ComputedRef<string>;
+    calendarDays: import("vue").ComputedRef<{
+        date: Date | null;
+    }[]>;
+    isInRange: (date: Date) => boolean;
+    isStart: (date: Date) => boolean;
+    isEnd: (date: Date) => boolean;
+    isToday: (date: Date) => boolean;
+    rangeLabel: import("vue").ComputedRef<string>;
+    rangeDays: import("vue").ComputedRef<number>;
+    pickDate: (date: Date) => void;
+    presetToday: () => void;
+    presetNextWeek: () => void;
+};