@feedmepos/mf-hrm-portal 2.3.1 → 2.3.2-dev

package/dist/src/views/scheduling/composables/schedule-popover-position.d.ts

@@ -1,16 +0,0 @@
-export interface ScheduleAnchorRect {
-    left: number;
-    right: number;
-    top: number;
-    bottom: number;
-}
-/** Measures the element a popover was opened from. Takes the rect while the anchor is still on
- * screen; a hidden or detached element measures 0×0 and counts as "no anchor". */
-export declare function anchorRectOf(el: Element | null | undefined): ScheduleAnchorRect | null;
-/** Port of HRM V6.2 placePopover(): below the anchor by preference (6px gap), flipped above when
- * there is no room, clamped to the viewport on both edges. Uses the popover's rendered size, so
- * call it once the element is in the DOM. */
-export declare function placePopover(el: HTMLElement, anchor: ScheduleAnchorRect | null): {
-    left: number;
-    top: number;
-};

package/dist/src/views/scheduling/composables/schedule-quick-pick.d.ts

@@ -1,23 +0,0 @@
-import type { CoverageSegment, Employee } from '../types';
-import type { ScheduleCoverageAxis } from './schedule-demand-domain';
-export interface QuickPickRules {
-    minHoursPerDay: number | null;
-    maxHoursPerDay: number | null;
-}
-export interface QuickPickCandidate {
-    start: string;
-    end: string;
-    /** Position name, or '' for any position. */
-    role: string;
-    /** Max short among the runs this shift covers. */
-    short: number;
-    label: string;
-    covers: string;
-    title: string;
-}
-export type QuickPickTranslate = (key: string, named?: Record<string, unknown>) => string;
-/** Up to 3 shifts for one employee on one day, built the way the auto-schedule planner builds
- * them: one per (short run, position the person can fill), padded to their daily minimum,
- * capped at their maximum, kept inside their availability window and clear of their existing
- * shifts. Rest-gap and weekly-cap checks are left to the shift editor's own warnings. */
-export declare function buildQuickPicks(emp: Employee, dayIdx: number, segments: CoverageSegment[], axis: ScheduleCoverageAxis, rules: QuickPickRules, qualifiedFor: (emp: Employee, position: string) => boolean, t?: QuickPickTranslate): QuickPickCandidate[];

package/dist/src/views/scheduling/composables/schedule-shift-time.d.ts

@@ -1,29 +0,0 @@
-import type { WorkSlot } from '../types';
-export type ScheduleBreakChoice = 0 | 30 | 60 | 90 | 120 | 'custom';
-export interface ScheduleShiftSegment {
-    start: string;
-    end: string;
-}
-/** The one break shape that names a clock window rather than just a duration — when present,
- * the card reads as two periods around it, each on its own line, instead of one span that
- * quietly got shorter. Shared by the employee view's own card and the area view's position-row
- * card, so a TIME_RANGE break draws the same split face wherever a shift is shown. */
-export declare function timeRangeBreakOf(sl: WorkSlot): {
-    startTime: string;
-    endTime: string;
-} | null;
-/** The two visible paid periods around a custom clock-window break. Shared by Weekly cards and
- * Daily timeline bars so the split wording cannot drift between views. */
-export declare function splitTimeLabels(sl: WorkSlot): [string, string] | null;
-/** Same face as `t12`, but never drops the minutes — two ranges stacked on a split card need
- * to line up at a glance, and "10am" next to "10:30am" reads as two different units. */
-export declare function t12Full(hhmm: string): string;
-/** A break length that doesn't match one of the presets becomes 'custom', carrying its own
- * minutes/unit back out for the caller to seed its custom-break fields from. */
-export declare function normalizeBreak(mins: number | undefined): {
-    choice: ScheduleBreakChoice;
-    customMins?: number;
-    customUnit?: 'mins' | 'hrs';
-};
-export declare function resolvedBreakMins(choice: ScheduleBreakChoice, customMins: number, customUnit: 'mins' | 'hrs'): number | undefined;
-export declare function segmentHours(seg: ScheduleShiftSegment, breakMins: number): number;

package/dist/src/views/scheduling/composables/schedule-time.d.ts

@@ -1,8 +0,0 @@
-/** Shared clock arithmetic for the scheduling board. All spans are minutes from midnight;
- * an end at or before the start is treated as an overnight end on the following day. */
-export declare function toMinutes(value: string): number;
-export declare function fromMinutes(value: number): string;
-export declare function spanMinutes(start: string, end: string): [number, number];
-export declare function durationMinutes(start: string, end: string): number;
-export declare function format12h(value: string): string;
-export declare function formatShortMinutes(value: number): string;

package/dist/src/views/scheduling/composables/schedule-week-cache.d.ts

@@ -1,9 +0,0 @@
-import type { Employee, OpenShift } from '../types';
-export { RANGE_LEN, mostRecentMonday, weekDates, weeksBetween } from './schedule-calendar';
-export interface WeekBucket {
-    employees: Employee[];
-    openShifts: OpenShift[];
-}
-/** `from` is the date the offset is relative to (the board passes the Monday it anchored on, so a
- * tab left open past midnight keeps building the week it is showing). */
-export declare function weekData(offset: number, from?: Date): WeekBucket;

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

@@ -1,9 +0,0 @@
-/** A long list shown as its first few entries plus "+N more", expandable in place. For chip rows
- * that can run to a hundred items (a person rostered at every outlet), which would otherwise
- * push the rest of the form off screen. */
-export declare function useCollapsedList<T>(items: () => T[], limit?: number): {
-    expanded: import("vue").Ref<boolean, boolean>;
-    shown: import("vue").ComputedRef<T[]>;
-    hiddenCount: import("vue").ComputedRef<number>;
-    toggle: () => void;
-};

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

@@ -1,16 +0,0 @@
-import { useAppStore } from '@feedmepos/mf-remy-panel';
-export interface RemyActivateOptions {
-    prompt?: string;
-    forceNewConversation?: boolean;
-    fullscreen?: boolean;
-}
-/** HRM never bundles or mounts a Remy panel of its own — `@feedmepos/mf-remy-panel` is externalised
- * by the shared vite preset, so inside the host portal this import resolves to the ONE panel
- * instance the host already created. The host portal owns initialisation (with env-specific
- * backend/license URLs) before any HRM view mounts. HRM must never call `initializeRemyChat`:
- * it re-initialises the shared panel instance and, without arguments, points it at production. */
-export interface RemyAppStoreApi {
-    store: ReturnType<typeof useAppStore>;
-    activate: (options: RemyActivateOptions) => Promise<void>;
-}
-export declare function useRemyAppStore(): RemyAppStoreApi;

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

@@ -1,137 +0,0 @@
-import type { Employee } from '../types';
-import type { ScheduleBoardApi } from './useScheduleBoard';
-import { type ScheduleAddEmployeeMode, type ScheduleAddEmployeeStep } from './schedule-add-employee-form';
-export type { ScheduleAddEmployeeForm, ScheduleAddEmployeeMode, ScheduleAddEmployeeStep, } from './schedule-add-employee-form';
-/** Add-employee wizard: a "how do you want to add them" step, then one detail form covering
- * identity, locations, pay, scheduling caps, availability, positions and POS access — plus
- * the "select existing POS staff" side dialog the first step can hand off to. */
-export declare function useScheduleAddEmployee(board: ScheduleBoardApi, options?: {
-    notify?: (message: string, type?: 'success' | 'error' | 'info') => void;
-}): {
-    open: import("vue").Ref<boolean, boolean>;
-    selectExistingOpen: import("vue").Ref<boolean, boolean>;
-    step: import("vue").Ref<ScheduleAddEmployeeStep, ScheduleAddEmployeeStep>;
-    mode: import("vue").Ref<ScheduleAddEmployeeMode, ScheduleAddEmployeeMode>;
-    form: {
-        name: string;
-        mobile: string;
-        dial: string;
-        employment: "full" | "part";
-        locations: string[];
-        payBasis: "hourly" | "monthly";
-        payAmount: string;
-        maxHours: string;
-        maxHoursPerDay: string;
-        minHours: string;
-        workingHoursEnabled: boolean;
-        overtimeEnabled: boolean;
-        maxHoursPerMonth: string;
-        availDays: boolean[];
-        availHours: {
-            from: string;
-            to: string;
-        }[];
-        preferences: string;
-        primaryPosition: string;
-        secondaryPositions: string[];
-        seniority: "" | "senior" | "junior";
-        passcode: string[];
-        masterUser: boolean;
-        masterCode: string;
-        posAccessEnabled: boolean;
-        posRoles: {
-            outlet: string;
-            roleId: string;
-        }[];
-    };
-    sectionId: import("vue").Ref<string, string>;
-    isEditing: import("vue").ComputedRef<boolean>;
-    editingEmployeeId: import("vue").Ref<number | null, number | null>;
-    locOpen: import("vue").Ref<boolean, boolean>;
-    secOpen: import("vue").Ref<boolean, boolean>;
-    secondaryOptions: import("vue").ComputedRef<string[]>;
-    isPart: import("vue").ComputedRef<boolean>;
-    dayLit: (index: number) => boolean;
-    avLabel: import("vue").ComputedRef<string>;
-    avAllLabel: import("vue").ComputedRef<string>;
-    maxHoursPlaceholder: import("vue").ComputedRef<string>;
-    minHoursPlaceholder: import("vue").ComputedRef<string>;
-    maxHoursPerDayPlaceholder: import("vue").ComputedRef<string>;
-    maxHoursPerMonthPlaceholder: import("vue").ComputedRef<string>;
-    toggleOvertime: () => void;
-    payUnit: import("vue").ComputedRef<string>;
-    effectiveRate: import("vue").ComputedRef<number>;
-    passcodeValue: import("vue").ComputedRef<string>;
-    passcodeOk: import("vue").ComputedRef<boolean>;
-    currentLocationLabel: import("vue").ComputedRef<string>;
-    locationOptions: import("vue").Reactive<string[]>;
-    isNewUser: import("vue").ComputedRef<boolean>;
-    footerHint: import("vue").ComputedRef<string>;
-    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>;
-    posRolesError: import("vue").ComputedRef<boolean>;
-    availabilityError: import("vue").ComputedRef<boolean>;
-    saving: import("vue").Ref<boolean, boolean>;
-    saveError: import("vue").Ref<string | null, string | null>;
-    deferScheduleWrites: import("vue").Ref<boolean, boolean>;
-    candidatesLoading: import("vue").Ref<boolean, boolean>;
-    candidatesError: import("vue").Ref<string | null, string | null>;
-    selectingExisting: import("vue").Ref<boolean, boolean>;
-    candidates: import("vue").Ref<{
-        employeeId: string;
-        name: string;
-        otherOutlets: string[];
-        locations: string[];
-    }[], import("../types").ExistingStaffCandidate[] | {
-        employeeId: string;
-        name: string;
-        otherOutlets: string[];
-        locations: string[];
-    }[]>;
-    candidatesTotal: import("vue").Ref<number, number>;
-    candidatesPage: import("vue").Ref<number, number>;
-    candidatesPageItemCount: import("vue").Ref<number, number>;
-    candidatesPageSize: number;
-    searchExisting: (search: string) => void;
-    goToExistingPage: (page: number, search: string) => void;
-    openWizard: (section: string) => void;
-    openEditFor: (emp: Employee) => void;
-    confirmClose: () => void;
-    close: () => void;
-    setMode: (m: ScheduleAddEmployeeMode) => void;
-    openSelectExisting: () => void;
-    closeSelectExisting: () => void;
-    pickExisting: (employeeId: string) => Promise<void>;
-    next: () => void;
-    back: () => void;
-    toggleMulti: (which: "loc" | "sec") => void;
-    toggleLocation: (location: string) => void;
-    removeLocation: (location: string) => void;
-    toggleSecondary: (position: string) => void;
-    removeSecondary: (position: string) => void;
-    setPrimaryPosition: (position: string) => void;
-    setPayBasis: (basis: "hourly" | "monthly") => void;
-    toggleAvailDay: (index: number) => void;
-    availAll: () => void;
-    setAvailHour: (index: number, field: "from" | "to", value: string) => void;
-    copyAvailHourDown: (index: number) => void;
-    setPasscodeDigit: (index: number, value: string) => void;
-    generatePasscode: () => Promise<void>;
-    isGeneratingPasscode: import("vue").Ref<boolean, boolean>;
-    togglePosAccess: () => void;
-    addPosRoleRow: () => void;
-    removePosRoleRow: (index: number) => void;
-    isCurrentOutletRow: (index: number) => boolean;
-    setPosRoleOutlet: (index: number, outlet: string) => void;
-    setPosRoleId: (index: number, roleId: string) => void;
-    posRoleOptionsFor: (outlet: string) => import("../../../types/role").Role[];
-    isPosRoleUsable: (role: import("../../../types/role").Role) => boolean;
-    setMasterUserRoleAccess: (roleIds: string[] | null | undefined) => void;
-    isPosOutletUsable: (outlet: string) => boolean;
-    posRolesHint: import("vue").ComputedRef<string>;
-    create: () => Promise<boolean>;
-};
-export type ScheduleAddEmployeeApi = ReturnType<typeof useScheduleAddEmployee>;

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

@@ -1,75 +0,0 @@
-import type { ScheduleBoardApi } from './useScheduleBoard';
-import type { ScheduleDemandApi } from './useScheduleDemand';
-import { type QuickPickCandidate } from './schedule-quick-pick';
-import { type ScheduleAnchorRect } from './schedule-popover-position';
-export interface ScheduleAddPickState {
-    open: boolean;
-    empId: number | null;
-    dayIdx: number | null;
-    /** Measured rect of the cell the popup opened from; the popup component places itself from it
-     * once rendered (V6.2 placePopover), writing the result to `left`/`top`. */
-    anchor: ScheduleAnchorRect | null;
-    left: number;
-    top: number;
-}
-export interface ScheduleAddPickLeaveOption {
-    reason: string;
-    /** i18n key for the row's label — `reason` itself is an id and stays English. */
-    labelKey: string;
-    swatch: string;
-}
-/** The "+ Add" quick-pick popover on an employee's empty cell — ported from the mockup's
- * openAddShiftPicker()/renderAddPickList(), scoped to what this board actually has: our one
- * active shift pattern, a fixed leave-reason list, and a demand-gap suggestion, all committed
- * directly (no clash confirmation dialogs — this board has no such infrastructure yet, and none
- * of its existing write paths gate on one either). Leave picks write a full-day approved leave
- * immediately rather than opening a creation form — there's no "book a leave" authoring flow
- * anywhere in this port yet, only the existing pending-request review modal, which assumes the
- * leave already exists. The mockup's "On this day" (join an existing open-shift group) section is
- * left out — it needs split-shift/group-joining machinery this board doesn't model. */
-export declare function useScheduleAddPick(board: ScheduleBoardApi, demand: ScheduleDemandApi, handlers: {
-    onCommitted: (message: string) => void;
-    onOpenFullEditor: (empId: number, dayIdx: number, slotIndex: number) => void;
-    /** The leave editor, on this cell. `reason` is the row's own type, or null for the plain "Leave" row. */
-    onOpenLeave: (empId: number, dayIdx: number, reason: string | null) => void;
-}): {
-    state: {
-        open: boolean;
-        empId: number | null;
-        dayIdx: number | null;
-        anchor: {
-            left: number;
-            right: number;
-            top: number;
-            bottom: number;
-        } | null;
-        left: number;
-        top: number;
-    };
-    query: import("vue").Ref<string, string>;
-    parsedRange: import("vue").ComputedRef<{
-        start: string;
-        end: string;
-    } | null>;
-    suggestions: import("vue").ComputedRef<QuickPickCandidate[]>;
-    filteredPatterns: import("vue").ComputedRef<{
-        key: string;
-        label: string;
-        start: string;
-        end: string;
-        color: string;
-        active: boolean;
-        breakMins: number;
-    }[]>;
-    filteredLeaves: import("vue").ComputedRef<ScheduleAddPickLeaveOption[]>;
-    hasResults: import("vue").ComputedRef<boolean>;
-    openFor: (empId: number, dayIdx: number, anchor: HTMLElement) => void;
-    close: () => void;
-    pickSuggested: (index: number) => void;
-    pickPattern: (key: string) => void;
-    pickTypedRange: (start: string, end: string) => void;
-    pickLeave: (reason: string) => void;
-    submitQuery: () => void;
-    openBlank: () => void;
-};
-export type ScheduleAddPickApi = ReturnType<typeof useScheduleAddPick>;

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

@@ -1,50 +0,0 @@
-import type { ScheduleBoardApi } from './useScheduleBoard';
-import type { Employee, WorkSlot } from '../types';
-export interface ScheduleAssignedSlot {
-    emp: Employee;
-    slot: WorkSlot;
-    /** This slot's position within the employee's day — what a drag of this card has to hand
-     * `board.moveShift`/`swapShifts` to pick the right period out of a day holding more than one. */
-    slotIndex: number;
-}
-export interface SchedulePositionCellMeta {
-    required: number;
-    filled: number;
-    open: number;
-    short: number;
-}
-/** Shared by the week and day area views, so a position's colour never disagrees between them. */
-export declare function positionSwatchClass(position: string): string;
-/** Where shifts and employees go that name no station at all — either because the outlet
- * hasn't named its positions yet, or because a shift deliberately names none. Rostering
- * shouldn't be blocked on the Positions page being filled in first, so this row exists
- * whenever there's anyone or anything to put in it (see `positionRows`). */
-export declare const ANY_POSITION_ROW = "Any position";
-/** Every other row is named after the position its shifts carry, so the row name and the
- * position key are the same string. This one differs: it collects records that name nothing,
- * so anything that queries BY position — qualifiedFor, assignedOn, a new shift's role — has to
- * ask for '' instead, or the row would answer "nobody holds Any position". */
-export declare function rowAsk(row: string): string;
-/** Whether this employee can be put on `position` — ported from the mockup's qualifiedFor().
- * Nobody having a named position yet reads as "any station", the same way an unspecialised
- * new-account roster does in the reference: rostering shouldn't be blocked on the Positions
- * page being filled in first. */
-export declare function qualifiedFor(emp: Employee, position: string): boolean;
-/** Week-by-area grouping: rows are positions (a RULES.coverage.full key), not employees.
- * Ported from the mockup's positionRows()/renderPositionBlock() — scoped to this board's single
- * "Unassigned" section and its existing WorkSlot/OpenShift model, so no split shifts and
- * no locked/closed-day states (neither exists anywhere in this port yet). */
-export declare function useScheduleAreaBoard(board: ScheduleBoardApi): {
-    positionRows: import("vue").ComputedRef<string[]>;
-    assignedOn: (dayIdx: number, position: string) => ScheduleAssignedSlot[];
-    poolFor: (position: string) => Employee[];
-    cellMeta: (dayIdx: number, position: string) => SchedulePositionCellMeta;
-    positionWeekMeta: (position: string) => {
-        required: number;
-        filled: number;
-        open: number;
-        short: number;
-        pool: number;
-    };
-};
-export type ScheduleAreaBoardApi = ReturnType<typeof useScheduleAreaBoard>;

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

@@ -1,11 +0,0 @@
-import type { ScheduleBoardApi } from './useScheduleBoard';
-/** Dragging a person from the staff rail onto a position/day cell opens a normal assigned shift. */
-export declare function useScheduleAreaDragDrop(board: ScheduleBoardApi, handlers: {
-    onCreateShift: (empId: number, dayIdx: number, position: string) => void;
-}): {
-    draggingEmpId: import("vue").Ref<number | null, number | null>;
-    startRailDrag: (empId: number) => void;
-    endRailDrag: () => void;
-    dropOnCell: (dayIdx: number, position: string) => void;
-};
-export type ScheduleAreaDragDropApi = ReturnType<typeof useScheduleAreaDragDrop>;

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

@@ -1,13 +0,0 @@
-import type { DaySlot, Employee, WorkSlot } from '../types';
-export interface ScheduleAssignmentMutationOptions {
-    dateFor: (offset: number, dayIdx: number) => string | null;
-    employeeAt: (offset: number, employeeId: number) => Employee | undefined;
-    currentOffset: () => number;
-    onPersistError?: (message: string) => void;
-}
-export declare function useScheduleAssignmentMutations(options: ScheduleAssignmentMutationOptions): {
-    persistSlot: (empId: number, dayIdx: number, oldSlot: DaySlot, newSlot: WorkSlot | WorkSlot[], dateOverride?: string | null, offset?: number, restoreDaySlot?: DaySlot) => Promise<void>;
-    persistRemoval: (oldSlot: DaySlot) => Promise<void>;
-    persistMove: (toEmpId: number, dayIdx: number, slot: WorkSlot | WorkSlot[], dateOverride?: string | null) => Promise<void>;
-    recoverPersistFailure: (error: unknown, fallback: string) => Promise<void>;
-};