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

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

@@ -0,0 +1,1316 @@
+import type { ScheduleBoardApi } from './useScheduleBoard';
+import type { ScheduleAddEmployeeApi } from './useScheduleAddEmployee';
+export type ScheduleOnboardingStep = 'hours' | 'staffing' | 'positions' | 'team' | 'availability' | 'review';
+export declare const STEP_LABELS: Record<ScheduleOnboardingStep, string>;
+export interface ScheduleOnboardingSession {
+    from: string;
+    to: string;
+}
+export interface ScheduleOnboardingDayHours {
+    open: boolean;
+    sessions: ScheduleOnboardingSession[];
+}
+export interface ScheduleOnboardingRange {
+    from: string;
+    to: string;
+    /** Blank until typed: an unset range asks for nobody. */
+    n: number | null;
+    roles: Array<{
+        position: string;
+        n: number | null;
+    }>;
+}
+export type TeamEmployment = 'full' | 'part';
+export type TeamBasis = 'monthly' | 'hourly';
+export interface TeamRow {
+    picked: boolean;
+    /** '' means "Any position" — a person with none. */
+    position: string;
+    second: string;
+    employment: TeamEmployment;
+    maxHours: string;
+    rate: string;
+    basis: TeamBasis;
+}
+export interface AvailDay {
+    on: boolean;
+    from: string;
+    to: string;
+}
+export interface AvailRow {
+    offDays: boolean[];
+    days: AvailDay[];
+}
+export interface ReviewRow {
+    step: ScheduleOnboardingStep;
+    title: string;
+    text: string;
+    sub?: string;
+}
+/** "Set up scheduling", step by step — V6.2's six-step flow. Positions, staffing demand and the
+ * team are real screens over real pieces. Operational hours start from the restaurant profile
+ * (RULES.dayHours / closedWeekdays) and are edited on a local copy: there is no scheduling
+ * endpoint for them yet (TODO: save them where the backend settles). Availability and Review are
+ * placeholders until their designs are ported. Finishing sets `scheduleSetupCompleted`. */
+export declare function useScheduleOnboardingWizard(board: ScheduleBoardApi, addEmployee: ScheduleAddEmployeeApi): {
+    board: {
+        dayNote: (dayIdx: number) => import("../types").ScheduleDayNote | null;
+        setDayNote: (dayIdx: number, title: string, desc: string) => void;
+        clearDayNote: (dayIdx: number) => void;
+        toggleClosed: (dayIdx: number) => {
+            closed: boolean;
+            rostered: number;
+        };
+        isManuallyClosed: (dayIdx: number) => boolean;
+        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;
+            name: string;
+            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;
+                assignmentId?: string | undefined;
+            } | {
+                timeOff: "approved" | "pending";
+                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;
+                assignmentId?: 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;
+        }[], import("../types").Employee[] | {
+            id: number;
+            name: string;
+            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;
+                assignmentId?: string | undefined;
+            } | {
+                timeOff: "approved" | "pending";
+                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;
+                assignmentId?: 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;
+        }[], import("../types").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;
+        }[], import("../types").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;
+        }[]>;
+        highlightEmpId: import("vue").Ref<number | null, number | null>;
+        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;
+            dayIdx: number;
+            kind: "add" | "change" | "remove";
+            label: string;
+        }[], import("../types").PendingChange[] | {
+            empId: number;
+            dayIdx: number;
+            kind: "add" | "change" | "remove";
+            label: string;
+        }[]>;
+        unpublishedChanges: import("vue").ComputedRef<import("../types").PendingChange[]>;
+        persistPublish: (items: Array<{
+            empId: number;
+            dayIdx: number;
+            slot: import("../types").WorkSlot;
+        }>) => Promise<void>;
+        recordChange: (empId: number, dayIdx: number, kind: import("../types").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;
+                    assignmentId?: string | undefined;
+                } | {
+                    timeOff: "approved" | "pending";
+                    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;
+                    assignmentId?: string | undefined;
+                }[] | null)[];
+            }[];
+        }[], import("../types").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;
+                    assignmentId?: string | undefined;
+                } | {
+                    timeOff: "approved" | "pending";
+                    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;
+                    assignmentId?: string | undefined;
+                }[] | null)[];
+            }[];
+        }[]>;
+        lastUpdatedAt: import("vue").Ref<Date | null, Date | null>;
+        lastPublishedAt: import("vue").Ref<Date | null, Date | null>;
+        pushVersion: (note: string, opts?: Partial<import("../types").ScheduleVersion>) => import("../types").ScheduleVersion;
+        snapshotSchedule: () => import("../types").ScheduleVersionSnapshot[];
+        scheduleStatus: import("vue").ComputedRef<import("../types").ScheduleStatusInfo>;
+        conflictCount: () => number;
+        granularity: import("vue").Ref<import("./useScheduleBoard").ScheduleGranularity, import("./useScheduleBoard").ScheduleGranularity>;
+        focusDayIdx: import("vue").Ref<number, number>;
+        setGranularity: (value: import("./useScheduleBoard").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) => import("../types").Employee[];
+        sectionCost: (sectionId: string, members?: import("../types").Employee[]) => number;
+        totalWeeklyCost: import("vue").ComputedRef<number>;
+        employeeById: (id: number) => import("../types").Employee | undefined;
+        commitShift: (empId: number, dayIdx: number, slot: import("../types").WorkSlot | import("../types").WorkSlot[]) => void;
+        commitShiftAt: (offset: number, empId: number, dayIdx: number, slot: import("../types").WorkSlot | import("../types").WorkSlot[]) => void;
+        removeShift: (empId: number, dayIdx: number) => void;
+        removeShiftAt: (offset: number, empId: number, dayIdx: number) => void;
+        moveShift: (fromEmpId: number, fromDayIdx: number, toEmpId: number, toDayIdx: number) => boolean;
+        swapShifts: (empIdA: number, empIdB: number, dayA: number, dayB?: 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;
+    };
+    open: import("vue").Ref<boolean, boolean>;
+    step: import("vue").Ref<ScheduleOnboardingStep, ScheduleOnboardingStep>;
+    stepIndex: import("vue").ComputedRef<number>;
+    isFirstStep: import("vue").ComputedRef<boolean>;
+    isLastStep: import("vue").ComputedRef<boolean>;
+    totalSteps: number;
+    positions: {
+        positions: import("vue").Ref<{
+            id: string;
+            name: string;
+        }[], import("./useSchedulePositions").SchedulePositionRow[] | {
+            id: string;
+            name: string;
+        }[]>;
+        count: import("vue").ComputedRef<number>;
+        isAdding: import("vue").Ref<boolean, boolean>;
+        newName: import("vue").Ref<string, string>;
+        editingId: import("vue").Ref<string | null, string | null>;
+        editingName: 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: (name: string) => number;
+        startAdd: () => void;
+        cancelAdd: () => void;
+        confirmAdd: () => Promise<void>;
+        startEdit: (id: string) => void;
+        cancelEdit: () => void;
+        saveEdit: (id: string) => Promise<void>;
+        askDelete: (id: string) => void;
+        cancelDelete: () => void;
+        confirmDelete: (id: string) => Promise<void>;
+    };
+    steps: ScheduleOnboardingStep[];
+    isSkippable: import("vue").ComputedRef<boolean>;
+    hours: import("vue").Reactive<ScheduleOnboardingDayHours[]>;
+    hoursMatchProfile: import("vue").ComputedRef<boolean>;
+    openDayCount: import("vue").ComputedRef<number>;
+    resetHours: () => void;
+    toggleDay: (dayIdx: number) => void;
+    addSession: (dayIdx: number) => void;
+    removeSession: (dayIdx: number, sessionIdx: number) => void;
+    setSessionTime: (dayIdx: number, sessionIdx: number, field: "from" | "to", value: string) => void;
+    demand: import("vue").Reactive<ScheduleOnboardingRange[][]>;
+    dmDay: import("vue").Ref<number, number>;
+    note: import("vue").Ref<string, string>;
+    staffingSaving: import("vue").Ref<boolean, boolean>;
+    namedPositions: import("vue").ComputedRef<string[]>;
+    suggestedPositions: import("vue").ComputedRef<string[]>;
+    daysSet: import("vue").ComputedRef<number>;
+    openDays: import("vue").ComputedRef<number[]>;
+    isShut: (dayIdx: number) => boolean;
+    dmPeak: (dayIdx: number) => number;
+    daySpan: (dayIdx: number) => string;
+    selectDay: (dayIdx: number) => void;
+    setRangeTime: (j: number, field: "from" | "to", value: string) => void;
+    setRangeCount: (j: number, value: string) => void;
+    addRange: () => void;
+    removeRange: (j: number) => void;
+    addRole: (j: number) => void;
+    setRole: (j: number, k: number, field: "position" | "n", value: string) => void;
+    removeRole: (j: number, k: number) => void;
+    namedTotal: (r: ScheduleOnboardingRange) => number;
+    copyDay: (mode: "all" | "wk" | "we") => void;
+    addPositionNamed: (name?: string) => void;
+    removePosition: (id: string) => void;
+    reviewRows: import("vue").ComputedRef<ReviewRow[]>;
+    goTo: (target: ScheduleOnboardingStep) => void;
+    avail: Record<number, AvailRow>;
+    avTab: import("vue").Ref<"full" | "part", "full" | "part">;
+    avPicked: Record<number, boolean>;
+    avBulkOpen: import("vue").Ref<boolean, boolean>;
+    avBulk: {
+        off: ("" | "y" | "n")[];
+        on: ("" | "y" | "n")[];
+        from: string;
+        to: string;
+    };
+    avBulkReady: import("vue").ComputedRef<boolean>;
+    avFulls: import("vue").ComputedRef<{
+        emp: {
+            id: number;
+            name: string;
+            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;
+                assignmentId?: string | undefined;
+            } | {
+                timeOff: "approved" | "pending";
+                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;
+                assignmentId?: 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;
+        };
+        row: TeamRow;
+    }[]>;
+    avParts: import("vue").ComputedRef<{
+        emp: {
+            id: number;
+            name: string;
+            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;
+                assignmentId?: string | undefined;
+            } | {
+                timeOff: "approved" | "pending";
+                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;
+                assignmentId?: 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;
+        };
+        row: TeamRow;
+    }[]>;
+    avGroup: import("vue").ComputedRef<{
+        emp: {
+            id: number;
+            name: string;
+            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;
+                assignmentId?: string | undefined;
+            } | {
+                timeOff: "approved" | "pending";
+                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;
+                assignmentId?: 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;
+        };
+        row: TeamRow;
+    }[]>;
+    avSelected: import("vue").ComputedRef<{
+        emp: {
+            id: number;
+            name: string;
+            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;
+                assignmentId?: string | undefined;
+            } | {
+                timeOff: "approved" | "pending";
+                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;
+                assignmentId?: 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;
+        };
+        row: TeamRow;
+    }[]>;
+    avFullDone: import("vue").ComputedRef<number>;
+    avPartDone: import("vue").ComputedRef<number>;
+    avOffCount: (dayIdx: number) => number | null;
+    avFullSub: (empId: number) => string;
+    avPartSummary: (empId: number) => string;
+    avShowsByDay: (empId: number) => boolean;
+    canDays: (empId: number) => number[];
+    avPickAll: (checked: boolean) => void;
+    toggleOff: (empId: number, dayIdx: number) => void;
+    toggleCan: (empId: number, dayIdx: number) => void;
+    setAvailTime: (empId: number, dayIdx: number | null, field: "from" | "to", v: string) => void;
+    toggleVary: (empId: number) => void;
+    bulkDay: (which: "off" | "on", dayIdx: number) => void;
+    applyAvBulk: () => void;
+    skip: () => void;
+    teamRows: import("vue").ComputedRef<{
+        emp: {
+            id: number;
+            name: string;
+            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;
+                assignmentId?: string | undefined;
+            } | {
+                timeOff: "approved" | "pending";
+                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;
+                assignmentId?: 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;
+        };
+        row: TeamRow;
+    }[]>;
+    teamPicked: import("vue").ComputedRef<number>;
+    teamAllPicked: import("vue").ComputedRef<boolean>;
+    teamSomePicked: import("vue").ComputedRef<boolean>;
+    pickAll: (checked: boolean) => void;
+    setPosition: (empId: number, value: string) => void;
+    setEmployment: (empId: number, kind: TeamEmployment) => void;
+    setHours: (empId: number, v: string) => void;
+    setRate: (empId: number, v: string) => void;
+    bulkOpen: import("vue").Ref<boolean, boolean>;
+    bulk: {
+        scope: "all" | "full" | "part" | "nopos" | "nopay";
+        position: string;
+        second: string;
+        employment: "" | TeamEmployment;
+        maxHours: string;
+        rate: string;
+        basis: "" | TeamBasis;
+    };
+    bulkCount: import("vue").ComputedRef<number>;
+    applyBulk: () => void;
+    BULK_NONE: string;
+    remainingCommon: import("vue").ComputedRef<string[]>;
+    ANY_POSITION_KEY: string;
+    holdersOf: (key: string) => {
+        id: number;
+        name: string;
+        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;
+            assignmentId?: string | undefined;
+        } | {
+            timeOff: "approved" | "pending";
+            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;
+            assignmentId?: 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;
+    }[];
+    candidatesFor: (key: string) => {
+        id: number;
+        name: string;
+        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;
+            assignmentId?: string | undefined;
+        } | {
+            timeOff: "approved" | "pending";
+            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;
+            assignmentId?: 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;
+    }[];
+    posPicker: import("vue").Ref<string | null, string | null>;
+    togglePicker: (key: string) => void;
+    assignTo: (empId: number, key: string) => Promise<void>;
+    unassign: (empId: number, key: string) => Promise<void>;
+    employeeCount: import("vue").ComputedRef<number>;
+    addEmployee: {
+        open: import("vue").Ref<boolean, boolean>;
+        selectExistingOpen: import("vue").Ref<boolean, boolean>;
+        step: import("vue").Ref<import("./schedule-add-employee-form").ScheduleAddEmployeeStep, import("./schedule-add-employee-form").ScheduleAddEmployeeStep>;
+        mode: import("vue").Ref<import("./schedule-add-employee-form").ScheduleAddEmployeeMode, import("./schedule-add-employee-form").ScheduleAddEmployeeMode>;
+        form: {
+            name: string;
+            mobile: string;
+            dial: string;
+            employment: "full" | "part";
+            locations: string[];
+            payBasis: "hourly" | "monthly";
+            payAmount: string;
+            maxHours: string;
+            minHours: string;
+            otAfterDaily: string;
+            maxOtHours: string;
+            availDays: boolean[];
+            availHours: {
+                from: string;
+                to: string;
+            }[];
+            preferences: string;
+            primaryPosition: string;
+            secondaryPositions: string[];
+            seniority: "" | "senior" | "junior";
+            passcode: string[];
+            masterUser: boolean;
+            roleId: string;
+            masterCode: string;
+        };
+        sectionId: import("vue").Ref<string, string>;
+        isEditing: import("vue").ComputedRef<boolean>;
+        locOpen: import("vue").Ref<boolean, boolean>;
+        secOpen: import("vue").Ref<boolean, boolean>;
+        secondaryOptions: import("vue").ComputedRef<string[]>;
+        isPart: import("vue").ComputedRef<boolean>;
+        dayLit: (i: number) => boolean;
+        avLabel: import("vue").ComputedRef<"Weekly availability" | "Time off days">;
+        avAllLabel: import("vue").ComputedRef<"Clear all" | "Select all" | "No days off" | "Every day off">;
+        maxHoursPlaceholder: import("vue").ComputedRef<"Hours per week" | "No cap">;
+        otAfterDailyPlaceholder: import("vue").ComputedRef<string>;
+        payUnit: import("vue").ComputedRef<"/month" | "/hour">;
+        effectiveRate: import("vue").ComputedRef<number>;
+        passcodeValue: import("vue").ComputedRef<string>;
+        passcodeOk: import("vue").ComputedRef<boolean>;
+        currentLocationLabel: import("vue").ComputedRef<string>;
+        roleOptions: import("vue").ComputedRef<{
+            value: string;
+            label: string;
+        }[]>;
+        roleError: import("vue").ComputedRef<boolean>;
+        masterCodeError: import("vue").ComputedRef<boolean>;
+        isNewUser: import("vue").ComputedRef<boolean>;
+        needsRole: import("vue").ComputedRef<boolean>;
+        footerHint: import("vue").ComputedRef<"Pick who — this outlet's own pay, position and hours are still set here." | "One short form. Rest days are set on their profile afterwards.">;
+        primaryRoleLabel: import("vue").ComputedRef<string>;
+        locationsSummary: import("vue").ComputedRef<string>;
+        payLine: import("vue").ComputedRef<string>;
+        nameError: import("vue").ComputedRef<boolean>;
+        passError: import("vue").ComputedRef<boolean>;
+        availabilityError: import("vue").ComputedRef<boolean>;
+        saving: import("vue").Ref<boolean, boolean>;
+        saveError: import("vue").Ref<string | null, string | null>;
+        candidatesLoading: import("vue").Ref<boolean, boolean>;
+        candidatesError: import("vue").Ref<string | null, string | null>;
+        openWizard: (section: string) => void;
+        openEditFor: (emp: import("../types").Employee) => void;
+        close: () => void;
+        setMode: (m: import("./schedule-add-employee-form").ScheduleAddEmployeeMode) => void;
+        openSelectExisting: () => void;
+        closeSelectExisting: () => void;
+        pickExisting: (employeeId: string) => void;
+        next: () => void;
+        back: () => void;
+        toggleMulti: (which: "loc" | "sec") => void;
+        toggleLocation: (loc: string) => void;
+        removeLocation: (loc: string) => void;
+        toggleSecondary: (pos: string) => void;
+        removeSecondary: (pos: string) => void;
+        setPrimaryPosition: (pos: string) => void;
+        setPayBasis: (basis: "hourly" | "monthly") => void;
+        toggleAvailDay: (i: number) => void;
+        availAll: () => void;
+        setAvailHour: (i: number, field: "from" | "to", value: string) => void;
+        copyAvailHourDown: (i: number) => void;
+        setPasscodeDigit: (i: number, value: string) => void;
+        generatePasscode: () => void;
+        create: () => Promise<boolean>;
+    };
+    openWizard: () => void;
+    close: () => void;
+    next: () => Promise<void>;
+    back: () => void;
+    jump: (idx: number) => void;
+    addTeamMember: () => void;
+};
+export type ScheduleOnboardingWizardApi = ReturnType<typeof useScheduleOnboardingWizard>;