@feedmepos/mf-hrm-portal 2.3.0-dev → 2.3.0-dev.11

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

@@ -1,19 +1,25 @@
 import type { ScheduleBoardApi } from './useScheduleBoard';
 import type { ScheduleDemandApi } from './useScheduleDemand';
-import { type ScheduleBreakChoice, type ScheduleShiftSegment } from './schedule-shift-time';
+import { type ScheduleShiftSegment } from './schedule-shift-time';
 export type { ScheduleBreakChoice, ScheduleShiftSegment } from './schedule-shift-time';
 export interface ScheduleHeadcountRole {
     position: string;
     count: number;
     sen: '' | 'senior' | 'junior';
 }
+export interface ScheduleWarningPart {
+    text: string;
+    emphasis?: boolean;
+}
 /** The unified shift popover — ported from the mockup's single `.shift-pop`, which answers
  * both "who is on this shift" and "what does this shift need" from one form. Picking a real
  * person in the `who` select turns it into an assignment; leaving it on "Empty shift" turns
  * it into open demand. Opened three ways: for an employee's cell (assign/edit), for a brand
  * new open shift (multi-position headcount authoring), or to edit one existing open-shift
  * record (single position, like an assigned shift's "Position needed" row). */
-export declare function useScheduleShiftPopover(board: ScheduleBoardApi, demand: ScheduleDemandApi): {
+export declare function useScheduleShiftPopover(board: ScheduleBoardApi, demand: ScheduleDemandApi, options?: {
+    onToast?: (message: string, type?: 'success' | 'error' | 'info') => void;
+}): {
     open: import("vue").Ref<boolean, boolean>;
     dayIdx: import("vue").Ref<number | null, number | null>;
     empId: import("vue").Ref<number | null, number | null>;
@@ -29,6 +35,7 @@ export declare function useScheduleShiftPopover(board: ScheduleBoardApi, demand:
         end: string;
     }[]>;
     role: import("vue").Ref<string, string>;
+    positionId: import("vue").Ref<string | undefined, string | undefined>;
     required: import("vue").Ref<number, number>;
     sen: import("vue").Ref<"" | "senior" | "junior", "" | "senior" | "junior">;
     empType: import("vue").Ref<"" | "full" | "part", "" | "full" | "part">;
@@ -36,7 +43,7 @@ export declare function useScheduleShiftPopover(board: ScheduleBoardApi, demand:
         position: string;
         count: number;
         sen: "" | "senior" | "junior";
-    }[], ScheduleHeadcountRole[] | {
+    }[], import("./useScheduleShiftDraft").ScheduleHeadcountRole[] | {
         position: string;
         count: number;
         sen: "" | "senior" | "junior";
@@ -56,13 +63,14 @@ export declare function useScheduleShiftPopover(board: ScheduleBoardApi, demand:
         };
         beforeSegs: import("../types").CoverageSegment[];
         afterSegs: import("../types").CoverageSegment[];
-        axis: import("./useScheduleDemand").ScheduleCoverageAxis;
+        axis: import("./schedule-demand-domain").ScheduleCoverageAxis;
     } | null>;
     requiresAssignment: import("vue").ComputedRef<boolean>;
     saveDisabled: import("vue").ComputedRef<boolean>;
-    saveTitle: import("vue").ComputedRef<"" | "Choose who covers it — this shift is answering a staffing gap, and a shift with nobody on it leaves that gap exactly as it is">;
+    dailyLimitExceeded: import("vue").ComputedRef<boolean>;
+    saveTitle: import("vue").ComputedRef<string>;
     saveLabel: import("vue").ComputedRef<"Create & assign" | "Save">;
-    breakChoice: import("vue").Ref<ScheduleBreakChoice, ScheduleBreakChoice>;
+    breakChoice: import("vue").Ref<import("./schedule-shift-time").ScheduleBreakChoice, import("./schedule-shift-time").ScheduleBreakChoice>;
     breakCustomMins: import("vue").Ref<number, number>;
     breakCustomUnit: import("vue").Ref<"mins" | "hrs", "mins" | "hrs">;
     breakMode: import("vue").Ref<"time" | "duration", "time" | "duration">;
@@ -77,6 +85,7 @@ export declare function useScheduleShiftPopover(board: ScheduleBoardApi, demand:
     positionOptions: import("vue").ComputedRef<string[]>;
     whoOptions: import("vue").ComputedRef<{
         id: number;
+        sourceId: string;
         name: string;
         employmentType: "FULLTIME" | "PARTTIME";
         role: string;
@@ -87,10 +96,12 @@ export declare function useScheduleShiftPopover(board: ScheduleBoardApi, demand:
         contractHours?: number | undefined;
         rate: number;
         positions: string[];
+        archivedPositions?: string[] | undefined;
         shifts: ({
             start: string;
             end: string;
             role: string;
+            positionId?: string | undefined;
             status: import("../types").ShiftStatus;
             clock?: {
                 in: string | null;
@@ -112,6 +123,7 @@ export declare function useScheduleShiftPopover(board: ScheduleBoardApi, demand:
                 breakPayType: "PAID" | "UNPAID";
             })[] | undefined;
             assignmentId?: string | undefined;
+            updatedAt?: string | undefined;
             splitGroupId?: string | undefined;
         } | {
             timeOff: "approved" | "pending";
@@ -138,6 +150,7 @@ export declare function useScheduleShiftPopover(board: ScheduleBoardApi, demand:
             start: string;
             end: string;
             role: string;
+            positionId?: string | undefined;
             status: import("../types").ShiftStatus;
             clock?: {
                 in: string | null;
@@ -159,6 +172,7 @@ export declare function useScheduleShiftPopover(board: ScheduleBoardApi, demand:
                 breakPayType: "PAID" | "UNPAID";
             })[] | undefined;
             assignmentId?: string | undefined;
+            updatedAt?: string | undefined;
             splitGroupId?: string | undefined;
         }[] | null)[];
         remarks: {
@@ -175,9 +189,16 @@ export declare function useScheduleShiftPopover(board: ScheduleBoardApi, demand:
         payBasis?: "hourly" | "monthly" | undefined;
         payAmount?: number | undefined;
         maxHours?: number | undefined;
-        maxOtHours?: number | undefined;
         minHours?: number | undefined;
-        otAfterDaily?: number | undefined;
+        minHoursPerDay?: number | undefined;
+        workingHours?: {
+            minHoursPerDay: number | null;
+            maxHoursPerDay: number | null;
+            maxHoursPerWeek: number | null;
+        } | undefined;
+        overtime?: {
+            maxHoursPerMonth: number | null;
+        } | undefined;
         preferences?: string[] | undefined;
         seniority?: "senior" | "junior" | "" | undefined;
         availDays?: boolean[] | undefined;
@@ -186,6 +207,7 @@ export declare function useScheduleShiftPopover(board: ScheduleBoardApi, demand:
             to: string;
         }[] | undefined;
         passcode?: string | undefined;
+        code?: string | undefined;
         masterUser?: boolean | undefined;
     }[]>;
     isAssigned: import("vue").ComputedRef<boolean>;
@@ -195,7 +217,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[]>;
+    warnings: import("vue").ComputedRef<ScheduleWarningPart[][]>;
     openForEmployee: (forEmpId: number, day: number, roleHint?: string, hours?: ScheduleShiftSegment, slotIndex?: number) => void;
     openForNewOpenShift: (day: number, roleHint?: string, hours?: ScheduleShiftSegment) => void;
     openForEditOpenShift: (openShiftId: number) => void;

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

@@ -8,7 +8,10 @@ import type { useScheduleLegend } from './useScheduleLegend';
  * the reference's renderedDays()-scoped totals. The 7-day RULES.salesForecast/SALES_CURVE
  * baseline underneath it stays weekly regardless — only the on-screen total and the
  * redistribution on edit are span-scoped. */
-export declare function useScheduleStatsRow(board: ScheduleBoardApi, costRail: ScheduleCostRailApi, legend: ReturnType<typeof useScheduleLegend>): {
+export declare function useScheduleStatsRow(board: ScheduleBoardApi, costRail: ScheduleCostRailApi, legend: ReturnType<typeof useScheduleLegend>, handlers?: {
+    onPersistError?: (message: string) => void;
+    onPersistSuccess?: (message: string) => void;
+}): {
     open: import("vue").Ref<boolean, boolean>;
     toggle: () => void;
     forecast: import("vue").Ref<number, number>;

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

@@ -1,3 +1,4 @@
+import { type Ref } from 'vue';
 import type { ScheduleBoardApi } from './useScheduleBoard';
 import type { ScheduleDemandRowApi } from './useScheduleDemandRow';
 import type { ScheduleDemandSheetApi } from './useScheduleDemandSheet';
@@ -7,6 +8,7 @@ import type { SchedulePublishApi } from './useSchedulePublish';
 import type { ScheduleExportApi } from './useScheduleExport';
 import type { IntroRecapRow } from './onboarding-types';
 interface TourDeps {
+    rootEl: Ref<HTMLElement | null>;
     board: ScheduleBoardApi;
     demandRow: ScheduleDemandRowApi;
     demandSheet: ScheduleDemandSheetApi;
@@ -22,9 +24,9 @@ interface TourDeps {
  * popover. No Back button, matching the source: the only way on is Next or Skip. */
 export declare function useScheduleTour(deps: TourDeps): {
     coach: {
-        open: import("vue").Ref<boolean, boolean>;
-        placing: import("vue").Ref<boolean, boolean>;
-        tip: import("vue").Ref<{
+        open: Ref<boolean, boolean>;
+        placing: Ref<boolean, boolean>;
+        tip: Ref<{
             title: string;
             body: string;
             count?: string | undefined;
@@ -85,7 +87,7 @@ export declare function useScheduleTour(deps: TourDeps): {
         skip: () => void;
     };
     start: () => void;
-    allSetOpen: import("vue").Ref<boolean, boolean>;
+    allSetOpen: Ref<boolean, boolean>;
     allSetRecap: import("vue").ComputedRef<IntroRecapRow[]>;
     closeAllSet: () => void;
 };

package/dist/src/views/scheduling/country-rules/index.d.ts

@@ -0,0 +1,24 @@
+import type { PayRate } from '../types';
+export interface CountryScheduleRules {
+    countryCode: string;
+    timezone: string;
+    payRate: PayRate;
+    overtime: {
+        maxHoursPerMonth: number | null;
+    };
+    workingHours: {
+        minHoursPerDay: number | null;
+        maxHoursPerDay: number | null;
+        maxHoursPerWeek: number | null;
+    };
+    recurringPublicHolidays: Array<{
+        month: number;
+        day: number;
+        name: string;
+    }>;
+    publicHolidays: Record<string, Record<string, string>>;
+}
+export declare function normalizeCountryCode(country: unknown): string;
+export declare function getCountryScheduleRules(country?: unknown): CountryScheduleRules;
+export declare function holidayNameForDate(rules: CountryScheduleRules, date: string): string | null;
+export declare const SUPPORTED_SCHEDULE_COUNTRIES: string[];

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

@@ -7,7 +7,10 @@ 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'>;
 /** The one section every board has. Scheduling sections are not a Mongo concept yet, so the
- * whole roster sits in this bucket and its `roles` list stays empty. */
+ * whole roster sits in this bucket and its `roles` list stays empty. Labelled "Assigned" rather
+ * than the id's own `UNASSIGNED` — this is where every shift's actual cost lives (the cost rail
+ * is the only place this label shows), and "Unassigned" read like a warning that nobody was
+ * covering those hours rather than just "not sorted into a work area yet". */
 export declare const SECTIONS: Section[];
 /** The position catalogue, from the Positions collection. Name-only: this is read as plain
  * strings everywhere on this board (dropdown options, coverage-matrix keys, role lookups), and
@@ -21,7 +24,9 @@ export declare const SECTIONS: Section[];
 export declare function positionIdOf(name: string): string | undefined;
 /** The selector shape every position-carrying save request wants — `undefined` for a blank
  * name (the field itself has nothing to name), a resolved id alongside the name otherwise. */
-export declare function positionSelectorOf(name: string | undefined): FdtoSchedulePositionSelectorReq | undefined;
+export declare function positionSelectorOf(name: string | undefined, positionId?: string): FdtoSchedulePositionSelectorReq | undefined;
+/** A saved position reference can outlive its catalogue entry after a soft delete. */
+export declare function isArchivedPosition(name: string | undefined, positionId?: string): boolean;
 /** Which coverage positions a station label counts toward. Positions ARE the roles in this
  * model — a shift records the position it is for — so nothing needs translating and this stays
  * empty, which makes `positionKeyOf()` pass a role through unchanged. */
@@ -41,13 +46,13 @@ export declare function positionSelectorOf(name: string | undefined): FdtoSchedu
  * no real forecast to shape: a curve invented here would make one day look busier than another
  * for no reason anybody could point at. */
 export declare const SALES_CURVE: number[];
-/** Scheduling configuration, from two places and no others: `payRate` is the whole content of
- * the ScheduleSettings document, and the trading window comes from the outlet's own Restaurants
- * profile (see `restaurantProfile` on the DTO).
+/** Scheduling configuration, from two places and no others: pay rates, setup state, and the
+ * monthly OT cap come from the ScheduleSettings document, and the trading window comes from the
+ * outlet's own Restaurants profile (see `restaurantProfile` on the DTO).
  *
  * The fields with no Mongo source stay zero rather than being guessed: `coverage` (per-template
- * headcount matrices), `salesForecast`, `labourTarget`, `budget`, the OT caps and the
- * notification channels. Nothing on screen derived from them is a figure this file made up.
+ * headcount matrices), `salesForecast`, `labourTarget`, `budget`, and notification channels.
+ * Nothing on screen derived from them is a figure this file made up.
  *
  * `openFrom`/`openTo` are the one pair that must never be blank — they are the axis every
  * coverage bar, day timeline and shift form is drawn against, and there is no such thing as a
@@ -63,6 +68,8 @@ 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;
+/** Stable identity for change tracking. Keep the numeric id only for legacy board lookups. */
+export declare function employeeKeyOf(employee: Pick<Employee, 'sourceId' | 'id'>): string;
 /** 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[];
@@ -82,6 +89,7 @@ export declare function scheduleDemand(): {
         n: number;
         roles: Array<{
             position: string;
+            positionId?: string;
             n: number;
         }>;
     }>>;
@@ -91,6 +99,7 @@ export declare function scheduleDemand(): {
         n: number;
         roles: Array<{
             position: string;
+            positionId?: string;
             n: number;
         }>;
     }>>;

package/dist/src/views/scheduling/locales/index.d.ts

@@ -49,6 +49,7 @@ export declare const i18nMessages: {
             status: {
                 draft: string;
                 published: string;
+                locked: string;
             };
             staffRail: {
                 title: string;
@@ -149,6 +150,25 @@ export declare const i18nMessages: {
                 thisWeek: string;
                 nextWeek: string;
             };
+            common: {
+                anyPosition: string;
+                none: string;
+                leaveAsIs: string;
+                monthly: string;
+                hourly: string;
+                everyone: string;
+                fullTime: string;
+                partTime: string;
+                noPosition: string;
+                noPay: string;
+                cancel: string;
+                done: string;
+                tryAgain: string;
+            };
+            positionModal: {
+                editTitle: string;
+                addTitle: string;
+            };
             comingSoon: string;
         };
     };
@@ -200,6 +220,7 @@ export declare const i18nMessages: {
             status: {
                 draft: string;
                 published: string;
+                locked: string;
             };
             staffRail: {
                 title: string;
@@ -300,6 +321,25 @@ export declare const i18nMessages: {
                 thisWeek: string;
                 nextWeek: string;
             };
+            common: {
+                anyPosition: string;
+                none: string;
+                leaveAsIs: string;
+                monthly: string;
+                hourly: string;
+                everyone: string;
+                fullTime: string;
+                partTime: string;
+                noPosition: string;
+                noPay: string;
+                cancel: string;
+                done: string;
+                tryAgain: string;
+            };
+            positionModal: {
+                editTitle: string;
+                addTitle: string;
+            };
             comingSoon: string;
         };
     };
@@ -351,6 +391,7 @@ export declare const i18nMessages: {
             status: {
                 draft: string;
                 published: string;
+                locked: string;
             };
             staffRail: {
                 title: string;
@@ -451,6 +492,25 @@ export declare const i18nMessages: {
                 thisWeek: string;
                 nextWeek: string;
             };
+            common: {
+                anyPosition: string;
+                none: string;
+                leaveAsIs: string;
+                monthly: string;
+                hourly: string;
+                everyone: string;
+                fullTime: string;
+                partTime: string;
+                noPosition: string;
+                noPay: string;
+                cancel: string;
+                done: string;
+                tryAgain: string;
+            };
+            positionModal: {
+                editTitle: string;
+                addTitle: string;
+            };
             comingSoon: string;
         };
     };
@@ -502,6 +562,7 @@ export declare const i18nMessages: {
             status: {
                 draft: string;
                 published: string;
+                locked: string;
             };
             staffRail: {
                 title: string;
@@ -602,6 +663,25 @@ export declare const i18nMessages: {
                 thisWeek: string;
                 nextWeek: string;
             };
+            common: {
+                anyPosition: string;
+                none: string;
+                leaveAsIs: string;
+                monthly: string;
+                hourly: string;
+                everyone: string;
+                fullTime: string;
+                partTime: string;
+                noPosition: string;
+                noPay: string;
+                cancel: string;
+                done: string;
+                tryAgain: string;
+            };
+            positionModal: {
+                editTitle: string;
+                addTitle: string;
+            };
             comingSoon: string;
         };
     };

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

@@ -0,0 +1,7 @@
+/** Shared scheduling limits and UI timing values. Keeping these named makes the product
+ * trade-offs visible when the API or board behavior changes. */
+export declare const EMPLOYEE_PAGE_SIZE = 500;
+export declare const MAX_BUSINESS_EMPLOYEE_PAGES = 10;
+export declare const PREFETCH_WEEKS = 6;
+export declare const RECENT_SAVE_FLASH_MS = 1500;
+export declare const EMPLOYEE_ID_BASE = 1000000;