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

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

@@ -0,0 +1,17 @@
+export declare const RANGE_LEN = 7;
+export declare function isoDateKey(date: Date): string;
+export declare function addDays(date: Date, days: number): Date;
+export declare function mostRecentMonday(from: Date): Date;
+export declare function weekDates(offset: number, from?: Date): Date[];
+export declare function weeksBetween(a: Date, b: Date): number;
+export declare function todayWeekdayIdx(): number;
+/** Monday-first weekday ids, matching the board's `dayIdx` (0 = Mon .. 6 = Sun). */
+export declare const WEEKDAY_IDS: readonly ["mon", "tue", "wed", "thu", "fri", "sat", "sun"];
+/** i18n key of a weekday's short name ("Mon" / "จ."). */
+export declare function weekdayShortKey(dayIdx: number): string;
+/** i18n key of a weekday's full name ("Monday" / "วันจันทร์"). */
+export declare function weekdayLongKey(dayIdx: number): string;
+/** BCP 47 tag for `Intl`/`toLocale*String` from the active i18n locale. English keeps the
+ * board's existing format (`enFallback`); Thai stays on the Gregorian calendar so years line up
+ * with ISO dates shown elsewhere instead of switching to the Buddhist era. */
+export declare function intlLocale(locale: string | undefined, enFallback?: string): string;

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

@@ -0,0 +1,24 @@
+import type { Employee, WorkSlot } from '../types';
+export interface ScheduleCostBreakdown {
+    hours: number;
+    overtimeHours: number;
+    baseCost: number;
+    overtimeCost: number;
+    totalCost: number;
+}
+export declare function costOfSlot(slot: WorkSlot, rate: number, multiplier: number): {
+    hours: number;
+    cost: number;
+};
+/** Splits a sequence of paid shift minutes at the employee's contract line. This is the single
+ * overtime/cost calculation used by rails and exports; callers provide the applicable pay rate
+ * multiplier for each slot. */
+export declare function costOfSlots(employee: Employee, slots: Array<{
+    slot: WorkSlot;
+    multiplier: number;
+}>): ScheduleCostBreakdown;
+/** The slice of vue-i18n's `t` the format helpers below need, so pure modules can take it as a
+ * parameter instead of calling `useI18n()` themselves. */
+export type ScheduleTranslate = (key: string, named?: Record<string, unknown>) => string;
+/** "7h 30m" / "7 ชม. 30 น." — hours rendered as whole hours plus leftover minutes. */
+export declare function formatHoursMinutes(hours: number, t: ScheduleTranslate): string;

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

@@ -0,0 +1,22 @@
+import { type ComputedRef } from 'vue';
+interface CurrencyFormat {
+    label: string;
+    /** Where the label sits next to the number: "RM 3" vs "3 บาท" — how each market reads it. */
+    position: 'before' | 'after';
+}
+export declare function currencyFormatFor(country: string | null | undefined): CurrencyFormat;
+export declare function currencyLabelFor(country: string | null | undefined): string;
+/** Adds the label to an already-formatted number, on the side that market reads it. */
+export declare function withCurrency(value: string, format: CurrencyFormat): string;
+export interface ScheduleCurrency {
+    /** "RM" / "บาท", from the current business country (not the UI language). */
+    currency: ComputedRef<string>;
+    /** True when the label goes after the number (บาท), so input adornments flip sides. */
+    currencyAfter: ComputedRef<boolean>;
+    /** "RM 1,234" / "1,234 บาท" — rounded to whole units unless `fractionDigits` is given. */
+    formatMoney: (amount: number, fractionDigits?: number) => string;
+    /** Adds the currency label to a number that is already formatted. */
+    withCurrency: (value: string | number) => string;
+}
+export declare function useScheduleCurrency(): ScheduleCurrency;
+export {};

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

@@ -0,0 +1,21 @@
+import type { ScheduleDayNote } from '../types';
+/** Everything a manager authors about a DATE rather than about a shift — the note on its
+ * card, whether the venue opens, whether it bills at the holiday rate. Keyed by ISO date
+ * (via the board's `dateKey`), not by weekday index: the mockup's flat single-week horizon
+ * could use the weekday index directly, but the board pages through weeks, and a note put on
+ * this Monday must not reappear on every other Monday. */
+export declare function useScheduleDayMeta(dateKey: (dayIdx: number) => string | null, handlers?: {
+    onPersistError?: (message: string) => void;
+}): {
+    dayNote: (dayIdx: number) => ScheduleDayNote | null;
+    setDayNote: (dayIdx: number, title: string, desc: string, isPublicHoliday?: boolean) => void;
+    clearDayNote: (dayIdx: number) => void;
+    isStandingClosedWeekday: (dayIdx: number) => boolean;
+    holidayName: (dayIdx: number) => string | null;
+    isPublicHoliday: (dayIdx: number) => boolean;
+    holidayRateApplies: (dayIdx: number) => boolean;
+    setPublicHoliday: (dayIdx: number, on: boolean) => void;
+    otRateOn: (dayIdx: number) => number;
+    regularRateOn: (dayIdx: number) => number;
+    isHoliday: (dayIdx: number) => boolean;
+};

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

@@ -0,0 +1,23 @@
+import type { DemandPeriod, Employee } from '../types';
+import { format12h as t12, formatShortMinutes as minToShort, fromMinutes as minToHHMM, spanMinutes as spanOf, toMinutes as toMin } from './schedule-time';
+export { minToHHMM, minToShort, spanOf, t12, toMin };
+export declare function rangeText(from: number, to: number): string;
+export declare function roleTotalOf(period: DemandPeriod): number;
+/** The unnamed part of a period's headcount. Derived so it cannot disagree with the total. */
+export declare function anyLeftOf(period: DemandPeriod): number;
+export interface ScheduleCoverageAxis {
+    from: number;
+    to: number;
+}
+/** Fills named position rows from the people on, as a maximum matching (Kuhn's augmenting
+ * paths) so a flexible person is moved off one row when another row has nobody else. Rows are
+ * tried in the order given (scarcest first); within a row, main-position holders are offered
+ * first, then secondary holders, then people with no positions. Returns heads filled per row
+ * (same order as `rows`) and the ids spent. */
+export declare function matchSlots(rows: Array<{
+    position: string;
+    required: number;
+}>, on: Employee[], qualified: (e: Employee, position: string) => boolean): {
+    got: number[];
+    spent: Set<number>;
+};

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

@@ -0,0 +1,7 @@
+import type { Employee } from '../types';
+/** Adds `positionName` to the employee's own profile — the backend write path a real
+ * "existing employee" record has (see `useScheduleAddEmployee.ts`'s `toEmployeeProfileFields`
+ * for the same shape, built from the add-employee form instead of a live `Employee`).
+ * Fire-and-forget: the local roster already shows the grant, and a failed profile write isn't
+ * worth a second error dialog on top of whatever caller-side save this followed. */
+export declare function grantSkillToEmployee(emp: Employee, positionName: string): void;

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

@@ -0,0 +1 @@
+export declare function errorMessage(error: unknown, fallback: string): string;

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

@@ -0,0 +1,14 @@
+export interface ExportShiftCell {
+    note: string;
+    shifts: {
+        when: string;
+        pos: string;
+    }[];
+}
+export declare function esc(value: string | number): string;
+export declare function cellText(value: string | ExportShiftCell): string;
+export declare function dayCellLines(value: ExportShiftCell): {
+    text: string;
+    kind: 'note' | 'when' | 'pos';
+}[];
+export declare function dayHeaderLabel(date: Date, locale?: string): string;

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

@@ -0,0 +1,9 @@
+import type { FdtoScheduleCreateTimeOffReq, FdtoScheduleTimeOff } from '@/types/schedule';
+import type { LeaveSlot } from '../types';
+/** The i18n key naming a leave slot's type, for display — `LeaveSlot.reason` stays English
+ * (other code matches on it). */
+export declare function timeOffLabelKey(slot: Pick<LeaveSlot, 'type' | 'leaveType'>): string;
+/** The create requests that keep the rest of a multi-day record alive once `date` is carved out
+ * of it. Single-day records leave nothing behind. The contract requires a same-day request to
+ * have matching parts, so a one-day remainder takes the part from its outer edge. */
+export declare function remainderRequests(record: FdtoScheduleTimeOff, date: string): FdtoScheduleCreateTimeOffReq[];

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

@@ -0,0 +1,16 @@
+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

@@ -0,0 +1,23 @@
+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

@@ -0,0 +1,29 @@
+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

@@ -0,0 +1,8 @@
+/** 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

@@ -0,0 +1,9 @@
+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

@@ -0,0 +1,9 @@
+/** 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

@@ -0,0 +1,16 @@
+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

@@ -0,0 +1,137 @@
+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

@@ -0,0 +1,75 @@
+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

@@ -0,0 +1,50 @@
+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

@@ -0,0 +1,11 @@
+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

@@ -0,0 +1,13 @@
+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>;
+};