@feedmepos/mf-hrm-portal 2.2.5 → 2.3.0-dev

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

@@ -0,0 +1,23 @@
+import type { ScheduleBoardApi } from './useScheduleBoard';
+export interface ScheduleOpenShiftMenuState {
+    open: boolean;
+    openShiftId: number | null;
+    left: number;
+    top: number;
+}
+/** The open-shift card's "⋯" menu (Assign/Edit/Remove) and its "N can cover" candidate
+ * count — split out from the shift popover itself, since these apply to the card at rest,
+ * not to the form. */
+export declare function useScheduleOpenShiftCard(board: ScheduleBoardApi): {
+    menu: {
+        open: boolean;
+        openShiftId: number | null;
+        left: number;
+        top: number;
+    };
+    openMenu: (openShiftId: number, anchor: HTMLElement) => void;
+    closeMenu: () => void;
+    remove: (openShiftId: number) => void;
+    candidateCountFor: (openShiftId: number) => number;
+};
+export type ScheduleOpenShiftCardApi = ReturnType<typeof useScheduleOpenShiftCard>;

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

@@ -0,0 +1,22 @@
+import type { ScheduleSelectOption } from '../components/ScheduleSelect.vue';
+/** Which outlet the board is scheduling, and the picker that changes it.
+ *
+ * On entry the host shell's own selection wins — mf-common keeps `currentRestaurant` in sync
+ * with the `?restaurantId=` in the URL, so arriving from anywhere else in the portal lands on
+ * the outlet that was already being looked at. Only when the shell has no opinion does this
+ * fall back to the first outlet in the business, which is better than an empty board.
+ *
+ * Switching from the picker writes the new id back into `?restaurantId=` too — via
+ * `router.replace`, not a navigation, so it does not reload the page or add a history entry.
+ * The picker already re-fetches everything the new outlet needs (see switchTo below); this just
+ * keeps the address bar honest about which one is on screen, so a refresh or a copied link lands
+ * back on it instead of silently snapping to whatever the shell had before. */
+export declare function useScheduleOutlet(): {
+    options: import("vue").ComputedRef<ScheduleSelectOption[]>;
+    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/useSchedulePageBootstrap.d.ts

@@ -0,0 +1,9 @@
+import type { ScheduleBoardApi } from './useScheduleBoard';
+import type { ScheduleDemandApi } from './useScheduleDemand';
+import type { ScheduleOutletApi } from './useScheduleOutlet';
+/** Owns SchedulePage's data bootstrap and loading lifecycle, separate from rendering concerns. */
+export declare function useSchedulePageBootstrap(board: ScheduleBoardApi, demand: ScheduleDemandApi, outlet: ScheduleOutletApi): {
+    booting: import("vue").Ref<boolean, boolean>;
+    showSkeleton: import("vue").ComputedRef<boolean>;
+    applyStoredDemand: () => void;
+};

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

@@ -0,0 +1,20 @@
+import type { ScheduleBoardApi } from './useScheduleBoard';
+import type { ScheduleDemandApi } from './useScheduleDemand';
+export type ClearKind = 'both' | 'shifts' | 'demand';
+export declare const CLEAR_COPY: Record<ClearKind, {
+    title: string;
+    message: string;
+    confirm: string;
+}>;
+type Snackbar = {
+    open: (options: {
+        message: string;
+        type: 'error' | 'info' | 'success';
+    }) => void;
+};
+export declare function useSchedulePageClearActions(board: ScheduleBoardApi, demand: ScheduleDemandApi, snackbar: Snackbar): {
+    clearKind: import("vue").Ref<ClearKind | null, ClearKind | null>;
+    onConfirmClear: () => Promise<void>;
+};
+export type SchedulePageClearActionsApi = ReturnType<typeof useSchedulePageClearActions>;
+export {};

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

@@ -0,0 +1,18 @@
+import type { ScheduleAddPickApi } from './useScheduleAddPick';
+import type { ScheduleAllShiftsRowApi } from './useScheduleAllShiftsRow';
+import type { ScheduleDayNoteApi } from './useScheduleDayNote';
+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 declare function useSchedulePageOverlays(apis: {
+    topbar: ScheduleTopbarApi;
+    dayNote: ScheduleDayNoteApi;
+    allShiftsRow: ScheduleAllShiftsRowApi;
+    gap: ScheduleGapPopoverApi;
+    timePicker: ScheduleTimePickerApi;
+    addPick: ScheduleAddPickApi;
+    shiftActions: ScheduleShiftActionsApi;
+    openShiftCard: ScheduleOpenShiftCardApi;
+}): void;

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

@@ -0,0 +1,52 @@
+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>;
+    editingId: import("vue").Ref<string | null, string | null>;
+    openNew: () => void;
+    openEdit: (id: string, currentName: string) => 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/useSchedulePositions.d.ts

@@ -0,0 +1,27 @@
+export interface SchedulePositionRow {
+    id: string;
+    name: string;
+}
+export declare function useSchedulePositions(): {
+    positions: import("vue").Ref<{
+        id: string;
+        name: string;
+    }[], SchedulePositionRow[] | {
+        id: string;
+        name: string;
+    }[]>;
+    count: import("vue").ComputedRef<number>;
+    isAdding: import("vue").Ref<boolean, boolean>;
+    newName: import("vue").Ref<string, string>;
+    pendingDeleteId: import("vue").Ref<string | null, string | null>;
+    saving: import("vue").Ref<boolean, boolean>;
+    error: import("vue").Ref<string | null, string | null>;
+    usageCountFor: (name: string) => number;
+    startAdd: () => void;
+    cancelAdd: () => void;
+    confirmAdd: () => Promise<void>;
+    askDelete: (id: string) => void;
+    cancelDelete: () => void;
+    confirmDelete: (id: string) => Promise<void>;
+};
+export type SchedulePositionsApi = ReturnType<typeof useSchedulePositions>;

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

@@ -0,0 +1,118 @@
+import type { ScheduleBoardApi } from './useScheduleBoard';
+import type { ScheduleVersion } from '../types';
+export interface VersionDiffRow {
+    name: string;
+    day: string;
+    kind: 'add' | 'rem' | 'chg';
+    from: string | null;
+    to: string | null;
+}
+/** The mockup's Publish modal (openPublish/renderPublish/confirmPublish) — draft vs. published
+ * stamps, a conflict-acknowledgement gate, the pending-change list, and per-version diffing
+ * against the previous version. The mockup's WhatsApp/push/email notify-channel block is not
+ * ported: it depends on per-employee notification-preference data that doesn't exist anywhere
+ * in this mock model, and building it would mean inventing a whole notification-preferences
+ * concept with no other consumer — publish here just publishes. */
+export declare function useSchedulePublish(board: ScheduleBoardApi): {
+    isOpen: import("vue").Ref<boolean, boolean>;
+    pubAcked: import("vue").Ref<boolean, boolean>;
+    showAllVersions: import("vue").Ref<boolean, boolean>;
+    expandedVersion: import("vue").Ref<number | null, number | null>;
+    open: () => void;
+    close: () => void;
+    conflicts: import("vue").ComputedRef<number>;
+    confirmDisabled: import("vue").ComputedRef<boolean>;
+    visibleVersions: import("vue").ComputedRef<{
+        v: number;
+        at: Date;
+        by: string;
+        note: string;
+        changeCount: number;
+        staffAffected: number;
+        snapshot: {
+            id: number;
+            name: string;
+            weekHours: number;
+            shifts: ({
+                start: string;
+                end: string;
+                role: string;
+                status: import("../types").ShiftStatus;
+                clock?: {
+                    in: string | null;
+                    out: string | null;
+                    status: "on-time" | "late" | "early-out" | "absent";
+                } | undefined;
+                conflict?: boolean | undefined;
+                conflictReason?: string | undefined;
+                openId?: number | undefined;
+                breakMins?: number | undefined;
+                breaks?: ({
+                    type: "DURATION";
+                    minutes: number;
+                    breakPayType: "PAID" | "UNPAID";
+                } | {
+                    type: "TIME_RANGE";
+                    startTime: string;
+                    endTime: string;
+                    breakPayType: "PAID" | "UNPAID";
+                })[] | undefined;
+                assignmentId?: string | undefined;
+                splitGroupId?: string | undefined;
+            } | {
+                timeOff: "approved" | "pending";
+                requestId?: string | undefined;
+                type?: "OFF_DAY" | "LEAVE" | undefined;
+                leaveType?: "ANNUAL" | "MEDICAL" | "EMERGENCY" | "UNPAID" | undefined;
+                reason: string;
+                half?: boolean | undefined;
+                halfPart?: "AM" | "PM" | undefined;
+                from?: string | undefined;
+                to?: string | undefined;
+                appliedOn?: string | undefined;
+                note?: string | undefined;
+                cert?: {
+                    name: string;
+                    size: string;
+                } | null | undefined;
+                bal?: {
+                    type: string;
+                    entitled: number;
+                    used: number;
+                } | undefined;
+            } | {
+                start: string;
+                end: string;
+                role: string;
+                status: import("../types").ShiftStatus;
+                clock?: {
+                    in: string | null;
+                    out: string | null;
+                    status: "on-time" | "late" | "early-out" | "absent";
+                } | undefined;
+                conflict?: boolean | undefined;
+                conflictReason?: string | undefined;
+                openId?: number | undefined;
+                breakMins?: number | undefined;
+                breaks?: ({
+                    type: "DURATION";
+                    minutes: number;
+                    breakPayType: "PAID" | "UNPAID";
+                } | {
+                    type: "TIME_RANGE";
+                    startTime: string;
+                    endTime: string;
+                    breakPayType: "PAID" | "UNPAID";
+                })[] | undefined;
+                assignmentId?: string | undefined;
+                splitGroupId?: string | undefined;
+            }[] | null)[];
+        }[];
+    }[]>;
+    toggleAllVersions: () => void;
+    toggleVersionDiff: (v: number) => void;
+    diffFor: (version: ScheduleVersion) => VersionDiffRow[];
+    confirm: () => void;
+    restoreVersion: (v: number) => void;
+};
+export type SchedulePublishApi = ReturnType<typeof useSchedulePublish>;

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

@@ -0,0 +1,27 @@
+import type { ScheduleBoardApi } from './useScheduleBoard';
+/** Range-calendar popover behind the topbar's date label — month grid + Today/This
+ * week/Next week presets, matching the mockup's range calendar. */
+export declare function useScheduleRangeCalendar(board: ScheduleBoardApi): {
+    open: import("vue").Ref<boolean, boolean>;
+    pos: {
+        left: number;
+        top: number;
+    };
+    toggle: (anchor?: HTMLElement) => void;
+    close: () => void;
+    cursorMonth: import("vue").Ref<Date, Date>;
+    shiftMonth: (delta: number) => void;
+    monthLabel: import("vue").ComputedRef<string>;
+    calendarDays: import("vue").ComputedRef<{
+        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

@@ -0,0 +1,241 @@
+import type { ScheduleBoardApi } from './useScheduleBoard';
+/** The employee grid's own row list — search-filtered, in the roster's own order.
+ *
+ * Ported from the mockup's getSorted()/EMP_ORDER. The grid's rows are the axis you edit along,
+ * so load-sorting them (the way the area view's staff rail does) meant every assignment moved
+ * that person down the list — the row you just used slid out from under the cursor. The order
+ * seeds from name order and only ever changes when a manager drags a name, so a row stays put
+ * while you work. There is deliberately no "sort by load" control here; that's a staff-rail
+ * feature. */
+export declare function useScheduleRoster(board: ScheduleBoardApi): {
+    search: import("vue").Ref<string, string>;
+    filteredEmployees: import("vue").ComputedRef<{
+        id: number;
+        name: string;
+        employmentType: "FULLTIME" | "PARTTIME";
+        role: string;
+        initials: string;
+        color: string;
+        weekHours: number;
+        pct: number;
+        contractHours?: number | undefined;
+        rate: number;
+        positions: string[];
+        shifts: ({
+            start: string;
+            end: string;
+            role: string;
+            status: import("../types").ShiftStatus;
+            clock?: {
+                in: string | null;
+                out: string | null;
+                status: "on-time" | "late" | "early-out" | "absent";
+            } | undefined;
+            conflict?: boolean | undefined;
+            conflictReason?: string | undefined;
+            openId?: number | undefined;
+            breakMins?: number | undefined;
+            breaks?: ({
+                type: "DURATION";
+                minutes: number;
+                breakPayType: "PAID" | "UNPAID";
+            } | {
+                type: "TIME_RANGE";
+                startTime: string;
+                endTime: string;
+                breakPayType: "PAID" | "UNPAID";
+            })[] | undefined;
+            assignmentId?: string | undefined;
+            splitGroupId?: string | undefined;
+        } | {
+            timeOff: "approved" | "pending";
+            requestId?: string | undefined;
+            type?: "OFF_DAY" | "LEAVE" | undefined;
+            leaveType?: "ANNUAL" | "MEDICAL" | "EMERGENCY" | "UNPAID" | undefined;
+            reason: string;
+            half?: boolean | undefined;
+            halfPart?: "AM" | "PM" | undefined;
+            from?: string | undefined;
+            to?: string | undefined;
+            appliedOn?: string | undefined;
+            note?: string | undefined;
+            cert?: {
+                name: string;
+                size: string;
+            } | null | undefined;
+            bal?: {
+                type: string;
+                entitled: number;
+                used: number;
+            } | undefined;
+        } | {
+            start: string;
+            end: string;
+            role: string;
+            status: import("../types").ShiftStatus;
+            clock?: {
+                in: string | null;
+                out: string | null;
+                status: "on-time" | "late" | "early-out" | "absent";
+            } | undefined;
+            conflict?: boolean | undefined;
+            conflictReason?: string | undefined;
+            openId?: number | undefined;
+            breakMins?: number | undefined;
+            breaks?: ({
+                type: "DURATION";
+                minutes: number;
+                breakPayType: "PAID" | "UNPAID";
+            } | {
+                type: "TIME_RANGE";
+                startTime: string;
+                endTime: string;
+                breakPayType: "PAID" | "UNPAID";
+            })[] | undefined;
+            assignmentId?: string | undefined;
+            splitGroupId?: string | undefined;
+        }[] | null)[];
+        remarks: {
+            author: string;
+            date: string;
+            type: "note" | "warning" | "praise";
+            text: string;
+        }[];
+        section: string;
+        compGroup?: string | undefined;
+        mobile?: string | undefined;
+        dial?: string | undefined;
+        locations?: string[] | undefined;
+        payBasis?: "hourly" | "monthly" | undefined;
+        payAmount?: number | undefined;
+        maxHours?: number | undefined;
+        maxOtHours?: number | undefined;
+        minHours?: number | undefined;
+        otAfterDaily?: number | undefined;
+        preferences?: string[] | undefined;
+        seniority?: "senior" | "junior" | "" | undefined;
+        availDays?: boolean[] | undefined;
+        availHours?: {
+            from: string;
+            to: string;
+        }[] | undefined;
+        passcode?: string | undefined;
+        masterUser?: boolean | undefined;
+    }[]>;
+    orderedEmployees: import("vue").ComputedRef<{
+        id: number;
+        name: string;
+        employmentType: "FULLTIME" | "PARTTIME";
+        role: string;
+        initials: string;
+        color: string;
+        weekHours: number;
+        pct: number;
+        contractHours?: number | undefined;
+        rate: number;
+        positions: string[];
+        shifts: ({
+            start: string;
+            end: string;
+            role: string;
+            status: import("../types").ShiftStatus;
+            clock?: {
+                in: string | null;
+                out: string | null;
+                status: "on-time" | "late" | "early-out" | "absent";
+            } | undefined;
+            conflict?: boolean | undefined;
+            conflictReason?: string | undefined;
+            openId?: number | undefined;
+            breakMins?: number | undefined;
+            breaks?: ({
+                type: "DURATION";
+                minutes: number;
+                breakPayType: "PAID" | "UNPAID";
+            } | {
+                type: "TIME_RANGE";
+                startTime: string;
+                endTime: string;
+                breakPayType: "PAID" | "UNPAID";
+            })[] | undefined;
+            assignmentId?: string | undefined;
+            splitGroupId?: string | undefined;
+        } | {
+            timeOff: "approved" | "pending";
+            requestId?: string | undefined;
+            type?: "OFF_DAY" | "LEAVE" | undefined;
+            leaveType?: "ANNUAL" | "MEDICAL" | "EMERGENCY" | "UNPAID" | undefined;
+            reason: string;
+            half?: boolean | undefined;
+            halfPart?: "AM" | "PM" | undefined;
+            from?: string | undefined;
+            to?: string | undefined;
+            appliedOn?: string | undefined;
+            note?: string | undefined;
+            cert?: {
+                name: string;
+                size: string;
+            } | null | undefined;
+            bal?: {
+                type: string;
+                entitled: number;
+                used: number;
+            } | undefined;
+        } | {
+            start: string;
+            end: string;
+            role: string;
+            status: import("../types").ShiftStatus;
+            clock?: {
+                in: string | null;
+                out: string | null;
+                status: "on-time" | "late" | "early-out" | "absent";
+            } | undefined;
+            conflict?: boolean | undefined;
+            conflictReason?: string | undefined;
+            openId?: number | undefined;
+            breakMins?: number | undefined;
+            breaks?: ({
+                type: "DURATION";
+                minutes: number;
+                breakPayType: "PAID" | "UNPAID";
+            } | {
+                type: "TIME_RANGE";
+                startTime: string;
+                endTime: string;
+                breakPayType: "PAID" | "UNPAID";
+            })[] | undefined;
+            assignmentId?: string | undefined;
+            splitGroupId?: string | undefined;
+        }[] | null)[];
+        remarks: {
+            author: string;
+            date: string;
+            type: "note" | "warning" | "praise";
+            text: string;
+        }[];
+        section: string;
+        compGroup?: string | undefined;
+        mobile?: string | undefined;
+        dial?: string | undefined;
+        locations?: string[] | undefined;
+        payBasis?: "hourly" | "monthly" | undefined;
+        payAmount?: number | undefined;
+        maxHours?: number | undefined;
+        maxOtHours?: number | undefined;
+        minHours?: number | undefined;
+        otAfterDaily?: number | undefined;
+        preferences?: string[] | undefined;
+        seniority?: "senior" | "junior" | "" | undefined;
+        availDays?: boolean[] | undefined;
+        availHours?: {
+            from: string;
+            to: string;
+        }[] | undefined;
+        passcode?: string | undefined;
+        masterUser?: boolean | undefined;
+    }[]>;
+    order: import("vue").Ref<number[], number[]>;
+    reorder: (draggedId: number, targetId: number, after: boolean) => Promise<void>;
+};
+export type ScheduleRosterApi = ReturnType<typeof useScheduleRoster>;

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

@@ -0,0 +1,57 @@
+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. */
+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(). */
+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;
+            };
+            REST_DAY: {
+                regular: number;
+                overtime: number;
+            };
+            PUBLIC_HOLIDAY: {
+                regular: number;
+                overtime: number;
+            };
+        };
+        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>;
+    load: () => Promise<void>;
+    open: (section?: ScheduleSettingsSection) => void;
+    close: () => boolean;
+    discard: () => void;
+    save: () => Promise<void>;
+};
+export type ScheduleSettingsApi = ReturnType<typeof useScheduleSettings>;

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

@@ -0,0 +1,17 @@
+/** "Set it up" banner — shown while the outlet has not finished scheduling setup, i.e. while
+ * `scheduleSetupCompleted` (schedule-store) is false. 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 shares that same gate, plus its own session dismiss so closing it doesn't
+ * also close the banner. `scheduleSetupCompleted` lands from an async fetch and starts `false`
+ * before that fetch resolves, so gating on it alone would flash the dialog open for an outlet
+ * whose real answer just hasn't arrived yet — `payload` is what distinguishes "not set up" from
+ * "don't know yet": it is only ever non-null once a board fetch for the current outlet has
+ * actually landed. */
+export declare function useScheduleSetupBanner(): {
+    open: import("vue").ComputedRef<boolean>;
+    start: () => void;
+    dismiss: () => Promise<void>;
+    welcomeOpen: import("vue").ComputedRef<boolean>;
+    dismissWelcome: () => void;
+};