@feedmepos/mf-hrm-portal 2.2.5-dev.7 → 2.2.5-dev.9

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

@@ -14,6 +14,7 @@ export declare function useScheduleOutlet(): {
     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>;
 };
 export type ScheduleOutletApi = ReturnType<typeof useScheduleOutlet>;

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

@@ -0,0 +1,50 @@
+export interface PositionModalPerson {
+    employeeId: string;
+    name: string;
+    initials: string;
+    /** Positions they already hold, main first — the row's second line. */
+    held: 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): {
+    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>;
+    openNew: () => 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/useSchedulePublish.d.ts

@@ -53,6 +53,8 @@ export declare function useSchedulePublish(board: ScheduleBoardApi): {
                 reason: string;
                 half?: boolean | undefined;
                 halfPart?: "AM" | "PM" | undefined;
+                from?: string | undefined;
+                to?: string | undefined;
                 appliedOn?: string | undefined;
                 note?: string | undefined;
                 cert?: {

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

@@ -3,7 +3,11 @@ import type { ScheduleBoardApi } from './useScheduleBoard';
  * week/Next week presets, matching the mockup's range calendar. */
 export declare function useScheduleRangeCalendar(board: ScheduleBoardApi): {
     open: import("vue").Ref<boolean, boolean>;
-    toggle: () => void;
+    pos: {
+        left: number;
+        top: number;
+    };
+    toggle: (anchor?: HTMLElement) => void;
     close: () => void;
     cursorMonth: import("vue").Ref<Date, Date>;
     shiftMonth: (delta: number) => void;
@@ -12,6 +16,11 @@ export declare function useScheduleRangeCalendar(board: ScheduleBoardApi): {
         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;

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

@@ -40,6 +40,8 @@ export declare function useScheduleRoster(board: ScheduleBoardApi): {
             reason: string;
             half?: boolean | undefined;
             halfPart?: "AM" | "PM" | undefined;
+            from?: string | undefined;
+            to?: string | undefined;
             appliedOn?: string | undefined;
             note?: string | undefined;
             cert?: {
@@ -82,6 +84,7 @@ export declare function useScheduleRoster(board: ScheduleBoardApi): {
         payAmount?: number | undefined;
         maxHours?: number | undefined;
         maxOtHours?: number | undefined;
+        minHours?: number | undefined;
         otAfterDaily?: number | undefined;
         preferences?: string[] | undefined;
         seniority?: "senior" | "junior" | "" | undefined;
@@ -124,6 +127,8 @@ export declare function useScheduleRoster(board: ScheduleBoardApi): {
             reason: string;
             half?: boolean | undefined;
             halfPart?: "AM" | "PM" | undefined;
+            from?: string | undefined;
+            to?: string | undefined;
             appliedOn?: string | undefined;
             note?: string | undefined;
             cert?: {
@@ -166,6 +171,7 @@ export declare function useScheduleRoster(board: ScheduleBoardApi): {
         payAmount?: number | undefined;
         maxHours?: number | undefined;
         maxOtHours?: number | undefined;
+        minHours?: number | undefined;
         otAfterDaily?: number | undefined;
         preferences?: string[] | undefined;
         seniority?: "senior" | "junior" | "" | undefined;

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

@@ -1,11 +1,11 @@
-/** "Set it up" banner — no positions means no roles to hang a pay rate or a shift pattern off,
- * so an empty catalogue is the one signal this checks. Dismissing is a session choice: the
- * banner is cheap enough to see again on the next visit while the outlet really is
- * unconfigured.
+/** "Set it up" banner — shown while the outlet has not finished scheduling setup, i.e. while
+ * `scheduleSetupCompleted` (schedule-store) is false. That flag is a placeholder until the
+ * backend settings carry it. Dismissing is a session choice: the banner is cheap enough to see
+ * again on the next visit while the outlet really is unconfigured.
  *
  * The welcome dialog answers a different question — "has this outlet's owner seen the
  * onboarding greeting" — and is deliberately NOT tied to whether positions currently exist:
- * the board's positions land from an async fetch, so gating the dialog on `POSITIONS.length`
+ * the board's data lands from an async fetch, so gating the dialog on it
  * meant a fast response for an outlet that already had positions saved could yank the dialog
  * shut within the same tick it opened, before anyone could read it. `localStorage`, keyed per
  * outlet, is what makes "seen" durable and independent of that fetch. */

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

@@ -68,6 +68,8 @@ export declare function useScheduleShiftActions(board: ScheduleBoardApi): {
             reason: string;
             half?: boolean | undefined;
             halfPart?: "AM" | "PM" | undefined;
+            from?: string | undefined;
+            to?: string | undefined;
             appliedOn?: string | undefined;
             note?: string | undefined;
             cert?: {
@@ -110,6 +112,7 @@ export declare function useScheduleShiftActions(board: ScheduleBoardApi): {
         payAmount?: number | undefined;
         maxHours?: number | undefined;
         maxOtHours?: number | undefined;
+        minHours?: number | undefined;
         otAfterDaily?: number | undefined;
         preferences?: string[] | undefined;
         seniority?: "senior" | "junior" | "" | undefined;
@@ -162,6 +165,8 @@ export declare function useScheduleShiftActions(board: ScheduleBoardApi): {
                 reason: string;
                 half?: boolean | undefined;
                 halfPart?: "AM" | "PM" | undefined;
+                from?: string | undefined;
+                to?: string | undefined;
                 appliedOn?: string | undefined;
                 note?: string | undefined;
                 cert?: {
@@ -204,6 +209,7 @@ export declare function useScheduleShiftActions(board: ScheduleBoardApi): {
             payAmount?: number | undefined;
             maxHours?: number | undefined;
             maxOtHours?: number | undefined;
+            minHours?: number | undefined;
             otAfterDaily?: number | undefined;
             preferences?: string[] | undefined;
             seniority?: "senior" | "junior" | "" | undefined;

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

@@ -43,6 +43,9 @@ export declare function useScheduleShiftPopover(board: ScheduleBoardApi, demand:
     }[]>;
     impact: import("vue").ComputedRef<{
         when: string;
+        pctBefore: number;
+        pctAfter: number;
+        stillShort: number;
         before: {
             required: number;
             scheduled: number;
@@ -100,6 +103,8 @@ export declare function useScheduleShiftPopover(board: ScheduleBoardApi, demand:
             reason: string;
             half?: boolean | undefined;
             halfPart?: "AM" | "PM" | undefined;
+            from?: string | undefined;
+            to?: string | undefined;
             appliedOn?: string | undefined;
             note?: string | undefined;
             cert?: {
@@ -142,6 +147,7 @@ export declare function useScheduleShiftPopover(board: ScheduleBoardApi, demand:
         payAmount?: number | undefined;
         maxHours?: number | undefined;
         maxOtHours?: number | undefined;
+        minHours?: number | undefined;
         otAfterDaily?: number | undefined;
         preferences?: string[] | undefined;
         seniority?: "senior" | "junior" | "" | undefined;
@@ -160,6 +166,7 @@ export declare function useScheduleShiftPopover(board: ScheduleBoardApi, demand:
     isSingleOpenRecord: import("vue").ComputedRef<boolean>;
     totalHours: import("vue").ComputedRef<number>;
     totalLabel: import("vue").ComputedRef<string>;
+    warnings: import("vue").ComputedRef<string[]>;
     openForEmployee: (forEmpId: number, day: number, roleHint?: string, hours?: ScheduleShiftSegment) => void;
     openForNewOpenShift: (day: number, roleHint?: string, hours?: ScheduleShiftSegment) => void;
     openForEditOpenShift: (openShiftId: number) => void;

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

@@ -1,3 +1,4 @@
+import type { Proposal } from '../types';
 import type { ScheduleBoardApi } from './useScheduleBoard';
 import type { ScheduleEmployeeLoad } from './useScheduleEmployeeIdentity';
 export type ScheduleRailSort = 'load' | 'name' | 'hours' | 'cost';
@@ -8,7 +9,9 @@ export type ScheduleRailRow = ScheduleEmployeeLoad;
  * column shows, plus each person's load bar and an "Open shifts" jump summary. Ported from
  * the mockup's renderStaffRail()/orderedRoster()/staffLoad(), scoped to a single week (no
  * day/area combination — Daily view stays employee-only for now). */
-export declare function useScheduleStaffRail(board: ScheduleBoardApi): {
+export declare function useScheduleStaffRail(board: ScheduleBoardApi, 
+/** Lazy: the auto-scheduler is built after the rail, and only read when rows are computed. */
+proposalAt?: () => ((empId: number, dayIdx: number) => Proposal | undefined) | undefined): {
     search: import("vue").Ref<string, string>;
     sort: import("vue").Ref<ScheduleRailSort, ScheduleRailSort>;
     rows: import("vue").ComputedRef<ScheduleEmployeeLoad[]>;

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

@@ -15,6 +15,8 @@ export interface ScheduleTimePickerState {
      * value gets read from to appear in the list at all. */
     value: string;
     query: string;
+    /** Which trigger button opened it, so only that one wears the open state. */
+    key: string;
     left: number;
     top: number;
 }
@@ -29,6 +31,7 @@ export declare function useScheduleTimePicker(): {
         open: boolean;
         value: string;
         query: string;
+        key: string;
         left: number;
         top: number;
     };
@@ -36,7 +39,9 @@ export declare function useScheduleTimePicker(): {
     amOptions: import("vue").ComputedRef<ScheduleTimePickerOption[]>;
     pmOptions: import("vue").ComputedRef<ScheduleTimePickerOption[]>;
     typedValue: import("vue").ComputedRef<string | null>;
-    openFor: (anchor: HTMLElement, value: string, pick: (hhmm: string) => void) => void;
+    openFor: (anchor: HTMLElement, value: string, pick: (hhmm: string) => void, key?: string) => void;
+    anchorRect: () => DOMRect | null;
+    isOpenFor: (key: string) => boolean;
     close: () => void;
     pick: (value: string) => void;
     submitQuery: () => void;

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

@@ -0,0 +1,9 @@
+import { type Ref } from 'vue';
+/** Pins the scheduling screen to the viewport so only the grid scrolls.
+ *
+ * `PortalShell` wraps every route in two unstyled divs, and the height chain above them is the
+ * host app's, not ours: with no definite height anywhere up there, `.sch { height: 100% }` has
+ * nothing to resolve against, the whole page grows to its content and the browser scrolls it —
+ * header rows included. Measuring where the shell starts and giving it the rest of the viewport
+ * is the one thing that does not depend on how the host lays itself out. */
+export declare function useScheduleViewportFit(rootEl: Ref<HTMLElement | null | undefined>): void;

package/dist/src/views/scheduling/data.d.ts

@@ -2,7 +2,6 @@ import type { CompGroupMeta, Employee, ExistingStaffCandidate, OpenShift, Schedu
 import type { FdtoSchedulePosition, FdtoSchedulePositionSelectorReq } from '@/types/schedule';
 export declare const UNASSIGNED = "unassigned";
 export declare const WEEKDAYS: string[];
-export declare const DEFAULT_POSITION = "Any position";
 export declare const ALL_STATIONS = "All Stations";
 /** Employment seniority is a closed set in the model, not something an outlet configures. */
 export declare const SENIORITY_OPTIONS: Array<'senior' | 'junior'>;
@@ -36,6 +35,9 @@ export declare const OUTLET: {
 /** Outlets a person may be rostered at. Filled by useScheduleOutlet from the restaurant store
  * — the board payload only ever describes the one outlet it was asked for. */
 export declare const LOCATION_OPTIONS: string[];
+/** Outlet id → name, so a person's POS `restaurantRole` (outlet ids) can be shown as the same
+ * labels LOCATION_OPTIONS offers. Filled alongside it by useScheduleOutlet. */
+export declare const LOCATION_LABEL_BY_ID: Record<string, string>;
 /** No Mongo source: departments and compensation groups are not modelled. The Add Employee
  * form renders these as empty pickers rather than offering choices nobody configured. */
 export declare const DEPT_OPTIONS: string[];
@@ -74,6 +76,9 @@ export declare function gridDayIdx(dayOfWeek: number): number;
 export declare function jsDayOfWeek(gridIdx: number): number;
 export declare function employeeIdOf(num: number): string | undefined;
 export declare function employeeNumberOf(employeeId: string): number;
+/** The outlets a person is rostered at, by name, from the POS roster's `restaurantRole`. */
+/** The outlet being scheduled goes first in a list of locations; the rest keep their order. */
+export declare function currentLocationFirst(locations: string[]): string[];
 export declare function createScheduleEmployees(dates?: Date[]): Employee[];
 /** Open shifts backed by a persisted Shift requirement never shipped — the backend never
  * carried that collection, so this always produced an empty list in practice. Kept as a stub,

package/dist/src/views/scheduling/schedule-store.d.ts

@@ -6,7 +6,15 @@ import type { FdtoScheduleAssignment, FdtoScheduleAutoScheduleReq, FdtoScheduleA
 export declare function isoDate(d: Date): string;
 export declare const payload: import("vue").ShallowRef<FdtoScheduleBoard | null, FdtoScheduleBoard | null>;
 export declare const loading: import("vue").Ref<boolean, boolean>;
+/** The POS roster (who the board's rows are) is fetched separately from the board window. */
+export declare const rosterLoading: import("vue").Ref<boolean, boolean>;
 export declare const loadError: import("vue").Ref<string | null, string | null>;
+/** Whether this outlet has finished setting up scheduling (onboarding). The schedule settings
+ * will carry this, but the backend has no such field yet, so it is a plain flag that defaults to
+ * "not finished" — the setup banner keys off it. TODO: when the field exists, set it from the
+ * settings payload where `payload` is applied (and flip it when the onboarding wizard finishes);
+ * nothing else needs to change. */
+export declare const scheduleSetupCompleted: import("vue").Ref<boolean, boolean>;
 /** Bumped every time `payload` is replaced. Anything that caches a derived view of the data
  * — the board's per-week buckets above all — watches this and rebuilds. */
 export declare const dataVersion: import("vue").Ref<number, number>;
@@ -53,6 +61,28 @@ export declare function setOutlet(restaurantId: string): boolean;
  * separate invalidation path. A generous page size rather than looping pages: real restaurant
  * headcounts sit nowhere near it. */
 export declare function ensureRestaurantEmployeesLoaded(restaurantId: string): Promise<void>;
+/** Re-reads this outlet's POS roster. The roster is what the board's rows are built from and is
+ * otherwise fetched once per outlet, so any write that changes who works here (add, remove)
+ * has to call this for the grid to show it. */
+export declare function refreshRestaurantEmployees(): Promise<void>;
+/** Gives an existing POS user a role at this outlet, so they land on its roster. */
+export declare function addEmployeeToOutlet(employeeId: string, roleId: string): Promise<void>;
+/** Takes a POS user off the given outlets' rosters; their other outlets are untouched. */
+export declare function removeEmployeeFromOutlets(employeeId: string, restaurantIds: string[]): Promise<void>;
+/** Takes a POS user off this outlet's roster only. */
+export declare function removeEmployeeFromOutlet(employeeId: string): Promise<void>;
+/** Every outlet each person works at (POS user id → outlet ids). The roster above is fetched
+ * FILTERED to one outlet, and a filtered read describes a person by that outlet alone, so the
+ * full list has to come from an unfiltered read. Paged until the total is covered. A failure
+ * leaves the map empty rather than failing the board: locations are display-only here. */
+export declare const employeeOutletIds: import("vue").ShallowRef<Record<string, string[]>, Record<string, string[]>>;
+/** Everyone in the business (POS user summaries: name, passcode, outlet roles), kept once and
+ * shared by the locations map, "select existing employee", passcode prefill and the role edits —
+ * the plain `/pos-users` read they used before returns every user-outlet row in one slow call. */
+export declare const businessEmployees: import("vue").ShallowRef<IFdtoPosUserSummary[], IFdtoPosUserSummary[]>;
+/** The cached business roster, fetched on first use. `force` re-reads it (after a write, or to
+ * refresh a list that is already on screen). Concurrent callers share one request. */
+export declare function ensureBusinessEmployees(force?: boolean): Promise<IFdtoPosUserSummary[]>;
 /** Guarantees the week starting `weekStart` is in memory, fetching a padded window around it
  * if it is not. Safe to call on every navigation: a week already covered costs nothing. */
 export declare function ensureWeekLoaded(weekStart: Date): Promise<void>;
@@ -98,6 +128,12 @@ export declare function saveScheduleDay(date: string, req: FdtoScheduleSaveSched
  * Position-specific headcount becomes its own row; any remaining headcount becomes an
  * unpositioned row for the same time range. */
 export declare function saveDemand(req: ScheduleReplaceDemandReq): Promise<void>;
+/** Copies one date's own demand rows onto another date, as that date's own rows. A date that
+ * already has demand of its own is left alone (nothing is overwritten), and a source date with
+ * none has nothing to copy: the standing weekday rule already covers the same weekday in every
+ * week, so repeating it per date would only shadow later edits to the rule. Returns how many rows
+ * were written. */
+export declare function copyDateDemand(fromDate: string, toDate: string): Promise<number>;
 export declare function generateAutoSchedule(req: FdtoScheduleAutoScheduleReq): Promise<FdtoScheduleAutoScheduleResult>;
 /** A one-off shift assignment — someone working these hours on this date, not answering any
  * Shift requirement. Deliberately does not reload: unlike `createEmployeeProfile` above, there
@@ -113,4 +149,3 @@ export declare function deleteAssignments(ids: string[]): Promise<void>;
 /** Flips a batch of existing assignments to one status in a single request — see
  * `ScheduleAPI.bulkUpdateAssignmentStatus`. */
 export declare function bulkUpdateAssignmentStatus(req: FdtoScheduleBulkUpdateAssignmentStatusReq): Promise<FdtoScheduleAssignment[]>;
-export declare function devResetOutlet(): Promise<number>;

package/dist/src/views/scheduling/types.d.ts

@@ -34,6 +34,9 @@ export interface LeaveSlot {
     reason: string;
     half?: boolean;
     halfPart?: 'AM' | 'PM';
+    /** Specific hours (HH:MM), for leave that is neither all day nor a morning / afternoon. */
+    from?: string;
+    to?: string;
     appliedOn?: string;
     note?: string;
     cert?: {
@@ -87,6 +90,9 @@ export interface Employee {
     payAmount?: number;
     maxHours?: number;
     maxOtHours?: number;
+    /** Shortest shift, in hours, this person will come in for. Asking for less is allowed but
+     * warned about in the shift popover. */
+    minHours?: number;
     otAfterDaily?: number;
     preferences?: string[];
     seniority?: 'senior' | 'junior' | '';
@@ -235,6 +241,8 @@ export interface ExistingStaffCandidate {
      * scheduling profile there, just enough context to tell two same-named people apart and to
      * warn against loaning someone who's clearly based elsewhere. */
     otherOutlets: string[];
+    /** Every outlet the person works at, by name (this one included when the POS lists it). */
+    locations: string[];
 }
 export interface CompGroupMeta {
     basis: 'Hourly' | 'Monthly';
@@ -287,7 +295,7 @@ export interface CoverageSegment {
     /** Nothing was asked for in these hours — an absence of a question, not a gap in one. */
     none: boolean;
 }
-export type DemandApplyMode = 'day' | 'weekday' | 'weekdays' | 'custom';
+export type DemandApplyMode = 'day' | 'every' | 'weekday' | 'weekdays' | 'custom';
 export interface NoticeBanner {
     variant: 'holiday' | 'info' | 'warning';
     dayIdx: number;
@@ -308,4 +316,9 @@ export interface Proposal {
     /** Set when this proposal would fill a named OpenShift record. */
     openId?: number;
     status: 'pending' | 'rejected';
+    /** The week these belong to: its first day's date. Proposals are day positions, so without
+     * this they would appear on whichever week is showing. */
+    weekKey?: string;
+    /** Why this person, for the card's tooltip. */
+    reason?: string;
 }