@alfadocs/ui-kit 1.23.0 → 1.25.1-calendar.0

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "1.23.0",
+  "packageVersion": "1.25.1-calendar.0",
   "components": [
     {
       "kind": "component",
@@ -17373,7 +17373,7 @@
         {
           "name": "triage_online_booking",
           "safety": "phi",
-          "description": "Work the online-bookings panel — the platform's bookings page hosted in the rail, badged with the bookings of the last thirty days still missing a patient or an operator. A row can be shown on the grid, which selects it and docks its details, or completed, which docks the editor prefilled with what the person typed on the booking site so the missing patient or operator can be filled in and saved. Completing writes patient-identifiable data.",
+          "description": "Review the online-bookings queue independently of the visible dates. The host owns membership and loading/error state. Show a row on the grid; completion is available only when the host enables it and the user can edit. Review-only rows remain in the queue on selection and cannot be dragged, resized or edited. Unknown last-seen data never marks a booking New. Completing writes patient-identifiable data.",
           "descriptionKey": "ui.agent.calendar.workflows.triageOnlineBooking",
           "uiActions": [
             "calendar.focus_event",

package/dist/agent-i18n/en.json

@@ -187,7 +187,7 @@
         "manageWaitingListEntry": "Add, amend or remove a waiting-list entry. The four-field form opens as a rail SUB-VIEW — from the toolbar split button's plus segment, from Add entry, or from a row's pencil — with a back arrow to the queue. Editing is refused on a row already linked to an appointment, because those fields belong to the appointment; the pencil stays focusable and names that reason. Remove deletes at once with no confirmation, platform parity, and its toast carries an Undo that puts the entry back. Writes patient-identifiable data.",
         "scheduleWaitingPatient": "Give a waiting patient a slot. \"Schedule\" on an unlinked row hands off to the free-slot finder seeded from the entry — operator, chair, duration, patient, care and colour already filled in — and booking a slot opens the editor carrying the entry, so saving books the appointment and takes the entry off the list. A row already linked to an appointment reads \"Reschedule\" and seeds the same finder, but booking there MOVES the existing appointment rather than creating a second one. Writes patient-identifiable data.",
         "findFreeSlot": "Search the practice for bookable time in the finder panel. Operator and chair scope are grouped checklists behind a popover per axis — a select-all row first, operators sectioned under their groups, nothing ticked searching every eligible resource — beside the care, the duration, the date range and, for a care that needs one, a medical-device select. The results list groups the slots under a day heading; a click steers the grid to that day and docks the editor prefilled with the date, time, duration, chair, operator and any seeded patient or care. The 185-day range warning is advisory (the search still runs), \"Show more slots\" pushes the To date out by 30 days and re-searches, and an alert names which business hours are missing when the practice or its operators hold none (it links to the scheduler only where the host supplies that navigation, which this workspace does not). Read-only until a slot is booked.",
-        "triageOnlineBooking": "Work the online-bookings panel — the platform's bookings page hosted in the rail, badged with the bookings of the last thirty days still missing a patient or an operator. A row can be shown on the grid, which selects it and docks its details, or completed, which docks the editor prefilled with what the person typed on the booking site so the missing patient or operator can be filled in and saved. Completing writes patient-identifiable data.",
+        "triageOnlineBooking": "Review the online-bookings queue independently of the visible dates. The host owns membership and loading/error state. Show a row on the grid; completion is available only when the host enables it and the user can edit. Review-only rows remain in the queue on selection and cannot be dragged, resized or edited. Unknown last-seen data never marks a booking New. Completing writes patient-identifiable data.",
         "printDaySheet": "Print the front-desk call sheet. The toolbar's printer icon opens a dialog asking which day — one day, never the visible range — and Print renders that day's appointments through the browser, scoped by the filters in force and masked when privacy mode is on. Nothing is sent to a server, but the sheet itself is a patient-identifiable document."
       }
     },

package/dist/components/appointment-card/index.js

@@ -1,5 +1,5 @@
-import { A as p } from "../../_chunks/appointment-card-Dzr3GeVz.js";
-import { A as e, a as o, b as r } from "../../_chunks/appointment-tray-4FUu_5NX.js";
+import { A as p } from "../../_chunks/appointment-card-CvUFFEdS.js";
+import { A as e, a as o, b as r } from "../../_chunks/appointment-tray-Z2GaOIYQ.js";
 import { i } from "../../_chunks/is-safe-url-DkETxeHz.js";
 export {
   p as AppointmentCard,

package/dist/components/appointment-timeline/index.js

@@ -1,4 +1,4 @@
-import { A as i, a as t } from "../../_chunks/appointment-timeline-DhHwmHo1.js";
+import { A as i, a as t } from "../../_chunks/appointment-timeline-DsMZY7U9.js";
 export {
   i as AppointmentTimeline,
   t as appointmentTimelineAgent

package/dist/components/calendar/calendar.d.ts

@@ -357,6 +357,21 @@ export interface CalendarProps {
     eventDurationEditable?: boolean;
     /** Allow click-drag to create. */
     selectable?: boolean;
+    /**
+     * Paint a placeholder over the range as it is dragged, so the user sees the
+     * appointment they are about to make rather than only the slot they started
+     * from. FullCalendar's own default is off; the kit turns it on wherever
+     * `selectable` is on, because a selection nobody can see is not a selection.
+     */
+    selectMirror?: boolean;
+    /**
+     * Keep the highlight when the pointer goes elsewhere. FullCalendar clears a
+     * selection on the next click anywhere, which is wrong when that click is
+     * the host opening an editor for the very slot just chosen: the form fills
+     * in and the grid forgets which slot it was about. Set false to hold it
+     * until the host clears it.
+     */
+    unselectAuto?: boolean;
     /** Height of the calendar. */
     height?: number | string;
     /** Extra class names on the wrapper. */

package/dist/components/calendar/index.js

@@ -1,4 +1,4 @@
-import { C as r, c as l, r as n } from "../../_chunks/calendar-BQPyUUPP.js";
+import { C as r, c as l, r as n } from "../../_chunks/calendar-CBqU-UIR.js";
 export {
   r as Calendar,
   l as calendarAgent,

package/dist/index.js

@@ -123,9 +123,9 @@ import { i as ji, i as Qi, i as Ji, i as Zi } from "./_chunks/is-safe-url-DkETxe
 import { A as ap, a as ep } from "./_chunks/agenda-tray-BweO8pDo.js";
 import { A as rp, a as op } from "./_chunks/ai-consent-banner-OggpS5hW.js";
 import { A as np } from "./_chunks/alert-CiJT540z.js";
-import { A as pp } from "./_chunks/appointment-card-Dzr3GeVz.js";
-import { A as lp, a as dp, b as Ap } from "./_chunks/appointment-tray-4FUu_5NX.js";
-import { A as fp, a as gp } from "./_chunks/appointment-timeline-DhHwmHo1.js";
+import { A as pp } from "./_chunks/appointment-card-CvUFFEdS.js";
+import { A as lp, a as dp, b as Ap } from "./_chunks/appointment-tray-Z2GaOIYQ.js";
+import { A as fp, a as gp } from "./_chunks/appointment-timeline-DsMZY7U9.js";
 import { D as Cp, d as Tp } from "./_chunks/dialog-UbKJCi1X.js";
 import { D as up, d as Pp } from "./_chunks/dropdown-menu-DU-Hrf33.js";
 import { E as Ep } from "./_chunks/error-boundary-ayXFCcq4.js";
@@ -184,7 +184,7 @@ import { A as ud } from "./_chunks/anamnesis-card-NTi4LLzI.js";
 import { D as Id, F as Ed, a as Rd, M as _d, b as bd, e as Nd, f as Dd, g as hd, c as Od, m as Fd, r as Ld, v as Md } from "./_chunks/muscle-scheme-BSJsI4-I.js";
 import { A as kd, a as Bd, b as Gd, c as Hd, d as vd, e as wd, C as Ud, f as Vd, g as Wd, D as Kd, h as Yd, E as Xd, L as qd, O as zd, P as jd, i as Qd, j as Jd, k as Zd, l as $d, R as aA, S as eA, m as sA, n as rA, o as oA, p as tA, q as nA, r as iA, s as pA, t as mA, u as lA, v as dA, w as AA, x as cA, y as fA, z as gA, B as SA, F as CA } from "./_chunks/optical-prescription-BvwuqTpl.js";
 import { B as xA, C as uA, O as PA, b as IA } from "./_chunks/booking-WXKbA69C.js";
-import { C as RA, c as _A, r as bA } from "./_chunks/calendar-BQPyUUPP.js";
+import { C as RA, c as _A, r as bA } from "./_chunks/calendar-CBqU-UIR.js";
 import { C as DA } from "./_chunks/calendar-event-card-66CEEWU6.js";
 import { R as OA } from "./_chunks/resource-chip-DYTG0IQQ.js";
 import { C as LA, c as MA } from "./_chunks/care-plan-card-CQVboTn1.js";
@@ -223,7 +223,7 @@ import { W as BS, a as GS } from "./_chunks/whatsapp-button-CuFIHJzG.js";
 import { C as vS, W as wS, a as US, b as VS, c as WS, i as KS, l as YS, m as XS, r as qS, w as zS, d as jS, e as QS, f as JS } from "./_chunks/workflow-map-dNzJjBWG.js";
 import { A as $S, a as aC, b as eC, c as sC } from "./_chunks/alia-sidebar-BWcWZivN.js";
 import { A as oC, a as tC, L as nC, P as iC, S as pC, T as mC, b as lC, c as dC, d as AC, e as cC, f as fC, g as gC, h as SC, i as CC, j as TC, k as xC, l as uC, m as PC, n as IC, o as EC, p as RC, r as _C, q as bC, s as NC, t as DC, u as hC } from "./_chunks/anamnesis-summary-rows-DwjqZgR5.js";
-import { C as FC, a as LC, b as MC, D as yC, c as kC, S as BC, V as GC, W as HC, d as vC, i as wC, m as UC, r as VC, u as WC, e as KC, f as YC } from "./_chunks/calendar-workspace-ax7xmSAp.js";
+import { C as FC, a as LC, b as MC, D as yC, c as kC, S as BC, V as GC, W as HC, d as vC, i as wC, m as UC, r as VC, u as WC, e as KC, f as YC } from "./_chunks/calendar-workspace-tm_Xrkrn.js";
 import { C as qC, M as zC, P as jC } from "./_chunks/marketplace-app-shell-C4AjQmvz.js";
 import { P as JC } from "./_chunks/payment-automation-upsell-DwQW2fRp.js";
 import { S as $C } from "./_chunks/signature-request-CwlAmVLw.js";

package/dist/patterns/calendar/calendar-workspace.d.ts

@@ -1,14 +1,28 @@
 import { type CalendarData } from './calendar.data';
 import type { CalendarJourney } from './calendar.journey';
 import { type CalendarPreferenceAdapter } from './calendar.preferences';
-import { type EditorPrefill } from './calendar.model';
+import { type CalendarRow, type EditorPrefill } from './calendar.model';
 import { type CalendarWorkspaceToolId, type WorkspaceDisplaySettings } from './calendar-workspace.model';
 export { WORKSPACE_TOOL, type CalendarWorkspaceToolId, } from './calendar-workspace.model';
+/** Host-owned queue membership, independent of the visible calendar range. */
+export interface CalendarOnlineBookings {
+    rows: readonly CalendarRow[];
+    status: 'loading' | 'ready' | 'error';
+    /** Opt in only when the host can load and persist canonical editor data. */
+    canComplete?: boolean;
+    /** Unknown or invalid means no booking receives a New marker. */
+    lastSeenIso?: string | null;
+    /** Creation timestamps when the booking has no contact payload. */
+    createdAtById?: Readonly<Record<string, string>>;
+    onRetry?: () => void;
+}
 export interface CalendarWorkspaceProps {
     /** The domain state and its handlers — the host implements them. */
     journey: CalendarJourney;
     /** The practice's read model, stable for a page load. */
     data: CalendarData;
+    /** Supplied rows are authoritative, including an explicitly empty queue. */
+    onlineBookings?: CalendarOnlineBookings;
     locale?: string;
     /** Host-level cog overrides. */
     initialDisplay?: Partial<WorkspaceDisplaySettings>;
@@ -68,6 +82,22 @@ export interface CalendarWorkspaceProps {
      *  calendar and the DOM hook anything outside React reaches it by.
      *  Override it only when two workspaces share one page. */
     id?: string;
+    /**
+     * The window the free-slot finder is about to search, raised before it runs.
+     *
+     * The finder projects free time from `journey.rows` and nothing else, so a
+     * host whose rows cover only the visible grid would have it report booked
+     * time as FREE over a range the user chose and the host never heard about.
+     * Load that range on this call: new rows re-render the panel, the search
+     * runs again, and the second answer is the correct one.
+     *
+     * A host that offers the finder without honouring this is showing staff free
+     * slots it has not checked.
+     */
+    onFinderSearchRange?: (range: {
+        from: Date;
+        to: Date;
+    }) => void;
 }
 /**
  * The cog's settings as the workspace opens with them: the remembered

package/dist/patterns/calendar/calendar-workspace.model.d.ts

@@ -362,9 +362,7 @@ export interface BookingRowView {
     /** Booked after the user last opened the page — the "(Nuovo)" marker. */
     isNew: boolean;
 }
-/** Bookings made after this instant carry the platform's "(Nuovo)" tag. */
-export declare const DEFAULT_BOOKINGS_LAST_SEEN_ISO = "2026-06-23T00:00:00";
-export declare function bookingRowView(row: CalendarRow, data: CalendarData, lastSeenMs?: number): BookingRowView;
+export declare function bookingRowView(row: CalendarRow, data: CalendarData, lastSeenMs?: number | null, createdAtIso?: string): BookingRowView;
 /** The nine advanced inputs, all optional. Empty = the input is unset;
  *  `operatorId` also accepts `NONE`, the platform's "no operator". */
 export interface WaitingListFilters {

package/dist/patterns/calendar/calendar.model.d.ts

@@ -514,6 +514,8 @@ export declare const FREE_SLOT_CAP = 20;
 export declare const SLOT_STEP_MIN = 30;
 /** Platform `FreeSlot::MAX_DAYS_TO_LOOK_AHEAD` — the finder warns past it. */
 export declare const FREE_SLOT_MAX_RANGE_DAYS = 185;
+/** The From→To span the finder opens on — the platform's own default. */
+export declare const FREE_SLOT_DEFAULT_HORIZON_DAYS = 30;
 /** Whole days between two dates — the finder's range rule. */
 export declare function rangeDays(from: Date, to: Date): number;
 export interface CalendarFreeSlot {

package/dist/patterns/calendar/calendar.sheets.d.ts

@@ -297,15 +297,19 @@ export declare function BacklogPanel({ items, locale, seed, signRequests, onProc
      *  mode (create / move banner) instead of opening the editor at once. */
     onPlaceWaiting?: (entry: CalendarWaitingEntry) => void;
 }): import("react/jsx-runtime").JSX.Element;
-export declare function BookingsPanel({ bookings, locale, privacy, onShowInCalendar, onComplete, }: {
+export declare function BookingsPanel({ bookings, locale, privacy, status, lastSeenIso, createdAtById, onRetry, onShowInCalendar, onComplete, }: {
     bookings: readonly CalendarRow[];
     locale?: string;
     /** Masks the patient names, in step with the grid. */
     privacy?: boolean;
+    status?: 'loading' | 'ready' | 'error';
+    lastSeenIso?: string | null;
+    createdAtById?: Readonly<Record<string, string>>;
+    onRetry?: () => void;
     /** Steers the grid to the booking and rings its card. */
     onShowInCalendar: (eventId: string) => void;
     /** Opens the editor to complete it (platform "Completa appuntamento"). */
-    onComplete: (row: CalendarRow) => void;
+    onComplete?: (row: CalendarRow) => void;
 }): import("react/jsx-runtime").JSX.Element;
 export declare function WaitingListPanel({ entries, rows, locale, onPlaceWaiting, onRemoveWaiting, onOpenEntryForm, onOpenPatient, onOpenAppointment, readOnly, }: {
     entries: CalendarWaitingEntry[];
@@ -388,7 +392,7 @@ export interface FindSlotsPlatformOptions {
      *  `GetGroupedOperatorService`); absent = one flat list. */
     operatorGroups?: readonly CalendarOperatorGroup[];
 }
-export declare function FindFreeSlotsPanel({ rows, locale, seed, onBookSlot, onShowInCalendar, platform, }: {
+export declare function FindFreeSlotsPanel({ rows, locale, seed, onBookSlot, onShowInCalendar, onSearchRange, platform, }: {
     rows: CalendarRow[];
     locale: string;
     /** Prefill context (the tool keys its panel by seed.tick). */
@@ -400,5 +404,18 @@ export declare function FindFreeSlotsPanel({ rows, locale, seed, onBookSlot, onS
      *  Calendar dims booked cards and glows the free ranges. The context
      *  carries the seeded patient/care into grid-click bookings. */
     onShowInCalendar: (slots: CalendarFreeSlot[] | null, fromDate?: Date, context?: AvailabilityContext) => void;
+    /**
+     * The window a search is about to cover, raised BEFORE it runs.
+     *
+     * The projection's busy set is `rows` and nothing else, so a host whose rows
+     * cover only the visible grid would have this report booked time as free
+     * over a range it was never told about. A host that loads on this call gets
+     * a corrected search for nothing: new rows re-render the panel and the
+     * search runs again.
+     */
+    onSearchRange?: (range: {
+        from: Date;
+        to: Date;
+    }) => void;
 }): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=calendar.sheets.d.ts.map

package/dist/patterns/calendar/calendar.surface.d.ts

@@ -1,7 +1,7 @@
 import { type CalendarPreferenceAdapter } from './calendar.preferences';
 import { type CalendarRow, type RailFocus, type EditorPrefill, type HistoryInput, type AvailabilityContext, type CalendarFreeSlot } from './calendar.model';
 import { type WorkspaceDisplaySettings, type CreateModeRequest, type PlacementRequest, type SaveNotice, type CalendarWorkspaceToolId } from './calendar-workspace.model';
-export declare function CalendarSurface({ rows, setRows, onFocus, locale, onComposeNew, onOpenWaitingList, onAddWaitingEntry, onOpenOnlineBookings, onlineBookingsCount, waitingBadgeCount, onVisibleRangeChange, selectedEventId, gotoRequest, onBookSlot, display, setDisplay, onHistory, readOnly, placement, onPlacementEnd, createMode, onCreateModeEnd, focusScroll, saveNotice, privacy, onPrivacyChange, availability, availabilityContext, availableTools, schedulerLicenseKey, id, preferences, }: {
+export declare function CalendarSurface({ rows, setRows, onFocus, locale, onComposeNew, onOpenWaitingList, onAddWaitingEntry, onOpenOnlineBookings, onlineBookingsCount, waitingBadgeCount, onVisibleRangeChange, selectedEventId, gotoRequest, onBookSlot, display, setDisplay, onHistory, readOnly, reviewOnlyEventIds, placement, onPlacementEnd, createMode, onCreateModeEnd, focusScroll, saveNotice, privacy, onPrivacyChange, availability, availabilityContext, availableTools, schedulerLicenseKey, id, preferences, }: {
     rows: CalendarRow[];
     setRows: React.Dispatch<React.SetStateAction<CalendarRow[]>>;
     onFocus: (focus: RailFocus) => void;
@@ -16,6 +16,8 @@ export declare function CalendarSurface({ rows, setRows, onFocus, locale, onComp
     availabilityContext: AvailabilityContext | null;
     /** No edit permission: no drag, no slot-click create. */
     readOnly?: boolean;
+    /** Host queue rows whose canonical editor data is not available yet. */
+    reviewOnlyEventIds?: ReadonlySet<string>;
     /** A Move… / Copy… armed from the details panel — the grid shows the
      *  mode banner and the next empty-slot click places the appointment. */
     placement?: PlacementRequest | null;

package/dist/patterns/calendar/index.d.ts

@@ -1,4 +1,4 @@
-export { CalendarWorkspace, initialWorkspaceDisplay, WORKSPACE_TOOL, type CalendarWorkspaceProps, type CalendarWorkspaceToolId, } from './calendar-workspace';
+export { CalendarWorkspace, initialWorkspaceDisplay, WORKSPACE_TOOL, type CalendarWorkspaceProps, type CalendarOnlineBookings, type CalendarWorkspaceToolId, } from './calendar-workspace';
 export { CalendarDataProvider, useCalendarData, type CalendarData, } from './calendar.data';
 export type { CalendarJourney } from './calendar.journey';
 export { SheetHostProvider, useSheetHost, type SheetHostContext, type SheetId, } from './calendar.host';

package/dist/patterns/calendar/index.js

@@ -1,4 +1,4 @@
-import { C as s, a as r, b as E, D as P, c as t, S, V as A, W as C, d, i as o, m as D, r as i, u as n, e as W, f as _ } from "../../_chunks/calendar-workspace-ax7xmSAp.js";
+import { C as s, a as r, b as E, D as P, c as t, S, V as A, W as C, d, i as o, m as D, r as i, u as n, e as W, f as _ } from "../../_chunks/calendar-workspace-tm_Xrkrn.js";
 export {
   s as CALENDAR_PREFERENCE_KEYS,
   r as CalendarDataProvider,