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

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

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

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

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

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

@@ -0,0 +1,18 @@
+import type { ScheduleBoardApi } from './useScheduleBoard';
+import type { ScheduleClashDetectionApi } from './useScheduleClashDetection';
+import type { ScheduleDragDropApi } from './useScheduleDragDrop';
+import type { ScheduleShiftActionsApi } from './useScheduleShiftActions';
+import type { ScheduleAutoScheduleApi } from './useScheduleAutoSchedule';
+interface UseSchedulePageCellDropOptions {
+    board: ScheduleBoardApi;
+    autoSchedule: ScheduleAutoScheduleApi;
+    dragDrop: ScheduleDragDropApi;
+    shiftActions: ScheduleShiftActionsApi;
+    clash: ScheduleClashDetectionApi;
+    dayHasAnyShift: (dayIdx: number) => boolean;
+    notify: (message: string, type: 'error') => void;
+}
+export declare function useSchedulePageCellDrop(options: UseSchedulePageCellDropOptions): {
+    onCellDrop: (empId: number, dayIdx: number, event: DragEvent) => void;
+};
+export {};

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

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

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

@@ -1,3 +1,4 @@
+import { ref } from 'vue';
 import type { ScheduleAddPickApi } from './useScheduleAddPick';
 import type { ScheduleAllShiftsRowApi } from './useScheduleAllShiftsRow';
 import type { ScheduleDayNoteApi } from './useScheduleDayNote';
@@ -5,9 +6,13 @@ import type { ScheduleGapPopoverApi } from './useScheduleGapPopover';
 import type { ScheduleOpenShiftCardApi } from './useScheduleOpenShiftCard';
 import type { ScheduleShiftActionsApi } from './useScheduleShiftActions';
 import type { ScheduleTimePickerApi } from './useScheduleTimePicker';
-import type { ScheduleTopbarApi } from './useScheduleTopbar';
+export type ScheduleTopbarMenu = 'actions' | 'export';
+export interface ScheduleTopbarApi {
+    openMenu: ReturnType<typeof ref<ScheduleTopbarMenu | null>>;
+    toggleMenu: (id: ScheduleTopbarMenu) => void;
+    closeMenus: () => void;
+}
 export declare function useSchedulePageOverlays(apis: {
-    topbar: ScheduleTopbarApi;
     dayNote: ScheduleDayNoteApi;
     allShiftsRow: ScheduleAllShiftsRowApi;
     gap: ScheduleGapPopoverApi;
@@ -15,4 +20,6 @@ export declare function useSchedulePageOverlays(apis: {
     addPick: ScheduleAddPickApi;
     shiftActions: ScheduleShiftActionsApi;
     openShiftCard: ScheduleOpenShiftCardApi;
-}): void;
+}): {
+    topbar: ScheduleTopbarApi;
+};

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

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

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

@@ -16,7 +16,9 @@ export interface PositionModalDone {
  * 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): {
+export declare function useSchedulePositionModal(onCreated?: (positionName: string) => void, options?: {
+    notify?: (message: string, type?: 'success' | 'error' | 'info') => void;
+}): {
     open: import("vue").Ref<boolean, boolean>;
     name: import("vue").Ref<string, string>;
     search: import("vue").Ref<string, string>;

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

@@ -2,7 +2,9 @@ export interface SchedulePositionRow {
     id: string;
     name: string;
 }
-export declare function useSchedulePositions(): {
+export declare function useSchedulePositions(options?: {
+    notify?: (message: string, type?: 'success' | 'error' | 'info') => void;
+}): {
     positions: import("vue").Ref<{
         id: string;
         name: string;

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

@@ -58,6 +58,7 @@ export declare function useSchedulePublish(board: ScheduleBoardApi): {
                     breakPayType: "PAID" | "UNPAID";
                 })[] | undefined;
                 assignmentId?: string | undefined;
+                updatedAt?: string | undefined;
                 splitGroupId?: string | undefined;
             } | {
                 timeOff: "approved" | "pending";
@@ -105,6 +106,7 @@ export declare function useSchedulePublish(board: ScheduleBoardApi): {
                     breakPayType: "PAID" | "UNPAID";
                 })[] | undefined;
                 assignmentId?: string | undefined;
+                updatedAt?: string | undefined;
                 splitGroupId?: string | undefined;
             }[] | null)[];
         }[];
@@ -112,7 +114,11 @@ export declare function useSchedulePublish(board: ScheduleBoardApi): {
     toggleAllVersions: () => void;
     toggleVersionDiff: (v: number) => void;
     diffFor: (version: ScheduleVersion) => VersionDiffRow[];
-    confirm: () => void;
+    confirm: () => Promise<void>;
     restoreVersion: (v: number) => void;
+    shareOpen: import("vue").Ref<boolean, boolean>;
+    shareVersion: import("vue").Ref<number | null, number | null>;
+    shareStaffAffected: import("vue").Ref<number, number>;
+    closeShare: () => void;
 };
 export type SchedulePublishApi = ReturnType<typeof useSchedulePublish>;

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

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

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

@@ -11,6 +11,7 @@ export declare function useScheduleRoster(board: ScheduleBoardApi): {
     search: import("vue").Ref<string, string>;
     filteredEmployees: import("vue").ComputedRef<{
         id: number;
+        sourceId: string;
         name: string;
         employmentType: "FULLTIME" | "PARTTIME";
         role: string;
@@ -46,6 +47,7 @@ export declare function useScheduleRoster(board: ScheduleBoardApi): {
                 breakPayType: "PAID" | "UNPAID";
             })[] | undefined;
             assignmentId?: string | undefined;
+            updatedAt?: string | undefined;
             splitGroupId?: string | undefined;
         } | {
             timeOff: "approved" | "pending";
@@ -93,6 +95,7 @@ export declare function useScheduleRoster(board: ScheduleBoardApi): {
                 breakPayType: "PAID" | "UNPAID";
             })[] | undefined;
             assignmentId?: string | undefined;
+            updatedAt?: string | undefined;
             splitGroupId?: string | undefined;
         }[] | null)[];
         remarks: {
@@ -124,6 +127,7 @@ export declare function useScheduleRoster(board: ScheduleBoardApi): {
     }[]>;
     orderedEmployees: import("vue").ComputedRef<{
         id: number;
+        sourceId: string;
         name: string;
         employmentType: "FULLTIME" | "PARTTIME";
         role: string;
@@ -159,6 +163,7 @@ export declare function useScheduleRoster(board: ScheduleBoardApi): {
                 breakPayType: "PAID" | "UNPAID";
             })[] | undefined;
             assignmentId?: string | undefined;
+            updatedAt?: string | undefined;
             splitGroupId?: string | undefined;
         } | {
             timeOff: "approved" | "pending";
@@ -206,6 +211,7 @@ export declare function useScheduleRoster(board: ScheduleBoardApi): {
                 breakPayType: "PAID" | "UNPAID";
             })[] | undefined;
             assignmentId?: string | undefined;
+            updatedAt?: string | undefined;
             splitGroupId?: string | undefined;
         }[] | null)[];
         remarks: {

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

@@ -1,25 +1,14 @@
 export type ScheduleSettingsSection = 'budget' | 'payrates' | 'overtime' | 'notify';
-/** Labour budget and Notifications are out of the General page for now — see
- * ScheduleSettingsPage's own note. `ScheduleSettingsSection` stays the full union (rather
- * than narrowing to a literal `'payrates' | 'overtime'`) so `draft`/`save()` below don't have
- * to change shape the day a section comes back; only the nav and the page's own rendering
- * are trimmed. */
+/** Keep unsupported sections out of the navigation until their API fields exist. */
 export declare const SETTINGS_SECTIONS: {
     key: ScheduleSettingsSection;
     label: string;
 }[];
-/** The mockup's Scheduling Settings page, scoped to the 3 tabs the topbar gear icon opens
- * (Labour budget / Overtime / Notifications). The mockup's sibling Shift & coverage / Seasonal
- * / Positions pages are a separate, out-of-scope epic — not built here. One draft object, like
- * the mockup's settingsDraft/spSnapshot(). */
+/** Settings currently supported by the schedule API: pay rates and monthly OT hours. */
 export declare function useScheduleSettings(): {
     isOpen: import("vue").Ref<boolean, boolean>;
     activeSection: import("vue").Ref<ScheduleSettingsSection, ScheduleSettingsSection>;
     draft: {
-        salesForecast: number;
-        labourTarget: number;
-        budgetFromSales: boolean;
-        budget: number;
         payRate: {
             NORMAL: {
                 overtime: number;
@@ -34,17 +23,6 @@ export declare function useScheduleSettings(): {
             };
         };
         otCapHours: number;
-        otBudget: number;
-        notify: {
-            waConnected: boolean;
-            waNumber: string;
-            waDisplayName: string;
-            defaults: {
-                wa: boolean;
-                push: boolean;
-                email: boolean;
-            };
-        };
     };
     dirty: import("vue").ComputedRef<boolean>;
     loading: import("vue").Ref<boolean, boolean>;

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

@@ -36,7 +36,9 @@ export interface ScheduleSwapState {
  * and trading two people's shifts on the same day. Both skip the mockup's OT/pay-band cost
  * preview and hard/soft override tiers — this board has no per-person pay bands to price
  * against, so a candidate is either qualified-and-free or it isn't offered at all. */
-export declare function useScheduleShiftActions(board: ScheduleBoardApi): {
+export declare function useScheduleShiftActions(board: ScheduleBoardApi, options?: {
+    onToast?: (message: string, type?: 'success' | 'error' | 'info') => void;
+}): {
     menu: {
         open: boolean;
         empId: number | null;
@@ -56,6 +58,7 @@ export declare function useScheduleShiftActions(board: ScheduleBoardApi): {
     changeSlot: import("vue").ComputedRef<import("../types").WorkSlot[]>;
     changeCandidates: import("vue").ComputedRef<{
         id: number;
+        sourceId: string;
         name: string;
         employmentType: "FULLTIME" | "PARTTIME";
         role: string;
@@ -91,6 +94,7 @@ export declare function useScheduleShiftActions(board: ScheduleBoardApi): {
                 breakPayType: "PAID" | "UNPAID";
             })[] | undefined;
             assignmentId?: string | undefined;
+            updatedAt?: string | undefined;
             splitGroupId?: string | undefined;
         } | {
             timeOff: "approved" | "pending";
@@ -138,6 +142,7 @@ export declare function useScheduleShiftActions(board: ScheduleBoardApi): {
                 breakPayType: "PAID" | "UNPAID";
             })[] | undefined;
             assignmentId?: string | undefined;
+            updatedAt?: string | undefined;
             splitGroupId?: string | undefined;
         }[] | null)[];
         remarks: {

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

@@ -0,0 +1,62 @@
+import type { WorkSlot } from '../types';
+import { type ScheduleBreakChoice, type ScheduleShiftSegment } from './schedule-shift-time';
+export interface ScheduleHeadcountRole {
+    position: string;
+    count: number;
+    sen: '' | 'senior' | 'junior';
+}
+export declare function useScheduleShiftDraft(): {
+    open: import("vue").Ref<boolean, boolean>;
+    dayIdx: import("vue").Ref<number | null, number | null>;
+    empId: import("vue").Ref<number | null, number | null>;
+    originalEmpId: import("vue").Ref<number | null, number | null>;
+    editingOpenShiftId: import("vue").Ref<number | null, number | null>;
+    isNew: import("vue").Ref<boolean, boolean>;
+    originalSlotIndex: import("vue").Ref<number, number>;
+    originalSlotCount: import("vue").Ref<number, number>;
+    originalSplitGroupId: import("vue").Ref<string | undefined, string | undefined>;
+    originalDayHadContent: import("vue").Ref<boolean, boolean>;
+    name: import("vue").Ref<string, string>;
+    segments: import("vue").Ref<{
+        start: string;
+        end: string;
+    }[], ScheduleShiftSegment[] | {
+        start: string;
+        end: string;
+    }[]>;
+    role: import("vue").Ref<string, string>;
+    required: import("vue").Ref<number, number>;
+    sen: import("vue").Ref<"" | "senior" | "junior", "" | "senior" | "junior">;
+    empType: import("vue").Ref<"" | "full" | "part", "" | "full" | "part">;
+    roles: import("vue").Ref<{
+        position: string;
+        count: number;
+        sen: "" | "senior" | "junior";
+    }[], ScheduleHeadcountRole[] | {
+        position: string;
+        count: number;
+        sen: "" | "senior" | "junior";
+    }[]>;
+    breakChoice: import("vue").Ref<ScheduleBreakChoice, ScheduleBreakChoice>;
+    breakCustomMins: import("vue").Ref<number, number>;
+    breakCustomUnit: import("vue").Ref<"mins" | "hrs", "mins" | "hrs">;
+    breakMode: import("vue").Ref<"time" | "duration", "time" | "duration">;
+    breakStartTime: import("vue").Ref<string, string>;
+    breakEndTime: import("vue").Ref<string, string>;
+    repeatDays: import("vue").Ref<boolean[], boolean[]>;
+    gapNote: import("vue").Ref<string | null, string | null>;
+    conflictNote: import("vue").Ref<string | null, string | null>;
+    grantSkill: import("vue").Ref<boolean, boolean>;
+    unassignMode: import("vue").Ref<boolean, boolean>;
+    resetCommon: (day: number) => void;
+    applyNormalizedBreak: (minutes: number | undefined) => void;
+    applyPersistedBreaks: (breaks: WorkSlot["breaks"], fallbackMins: number | undefined) => void;
+    resolvedBreakMins: () => number | undefined;
+    resolvedBreaks: () => WorkSlot["breaks"];
+    buildDraftSlot: () => WorkSlot | WorkSlot[];
+    close: () => void;
+    removeSegment: (index: number) => void;
+    addRole: () => void;
+    removeRole: (index: number) => void;
+    segmentHoursOf: (segment: ScheduleShiftSegment) => number;
+};

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

@@ -0,0 +1,17 @@
+import type { ComputedRef } from 'vue';
+import type { ScheduleBoardApi } from './useScheduleBoard';
+import { useScheduleShiftDraft } from './useScheduleShiftDraft';
+type ShiftDraft = ReturnType<typeof useScheduleShiftDraft>;
+interface UseScheduleShiftPersistenceOptions {
+    draft: ShiftDraft;
+    saveDisabled: ComputedRef<boolean>;
+    showGrantSkill: ComputedRef<boolean>;
+    onToast?: (message: string, type?: 'success' | 'error' | 'info') => void;
+}
+/** Mutations for the shift popover. Draft editing stays separate so the UI can preview and
+ * validate without owning board writes. */
+export declare function useScheduleShiftPersistence(board: ScheduleBoardApi, options: UseScheduleShiftPersistenceOptions): {
+    save: () => void;
+    remove: () => void;
+};
+export {};

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

@@ -1,6 +1,6 @@
 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;
@@ -13,7 +13,9 @@ export interface ScheduleHeadcountRole {
  * 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>;
@@ -36,7 +38,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 +58,13 @@ 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">;
     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 +79,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;
@@ -112,6 +115,7 @@ export declare function useScheduleShiftPopover(board: ScheduleBoardApi, demand:
                 breakPayType: "PAID" | "UNPAID";
             })[] | undefined;
             assignmentId?: string | undefined;
+            updatedAt?: string | undefined;
             splitGroupId?: string | undefined;
         } | {
             timeOff: "approved" | "pending";
@@ -159,6 +163,7 @@ export declare function useScheduleShiftPopover(board: ScheduleBoardApi, demand:
                 breakPayType: "PAID" | "UNPAID";
             })[] | undefined;
             assignmentId?: string | undefined;
+            updatedAt?: string | undefined;
             splitGroupId?: string | undefined;
         }[] | null)[];
         remarks: {

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: {
+        maxMonthlyHours: number | null;
+        afterDailyHours: number | null;
+    };
+    workingHours: {
+        standardWeeklyHours: number | null;
+        maxDailyHours: 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
@@ -41,13 +44,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 +66,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[];