@alfadocs/ui-kit 1.25.0 → 1.25.1-calendar.10

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.data.d.ts

@@ -22,6 +22,7 @@
  */
 import { type ReactNode } from 'react';
 import type { CalendarResource } from '../../components/calendar';
+import type { PaletteSwatch } from '../../components/color-picker';
 import type { AppointmentItem } from '../../components/appointment-card';
 import type { NotesPanelNote } from '../../components/notes-panel';
 import type { TasksPanelItem } from '../../components/tasks-panel';
@@ -37,6 +38,13 @@ export interface CalendarData {
     operatorAbsences: Record<string, readonly string[]>;
     /** Operator id → absence display title (a sibling map, optional per operator). */
     operatorAbsenceTitles: Record<string, string>;
+    /**
+     * Appointment colours the host accepts. When omitted, the workspace uses
+     * its documented Google-style fallback palette for demos and legacy hosts.
+     * A platform host should provide its configured DoctorColor values so a
+     * colour selected in the editor always maps back to a writable colour id.
+     */
+    appointmentPalette?: readonly PaletteSwatch[];
     holidays: readonly CalendarHoliday[];
     /** Practice-closed local ISO dates. */
     closedDates: readonly string[];
@@ -61,6 +69,15 @@ export interface CalendarData {
      *  through `carePlanById` / `openCarePlansForPatient`. */
     carePlans?: readonly CalendarCarePlan[];
     patients: readonly CalendarPatient[];
+    /** Optional host typeahead. Omit for client filtering of `patients`.
+     * The picker debounces nonblank queries, aborts superseded requests and
+     * keeps the host's result order, including matches by phone or number.
+     * Before resolving, make returned records available through `patientById`
+     * so other patient-dependent fields can resolve the chosen id. Reject
+     * failures; an empty array means a successful search with no matches. */
+    searchPatients?(query: string, options: {
+        signal: AbortSignal;
+    }): Promise<readonly CalendarPatient[]>;
     /** The appointments and tasks as the host loaded them, no resource axis. */
     baseEvents: readonly CalendarBaseEvent[];
     /** Event id → appointment extras (patient, operator, chair, care, billing). */

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

@@ -90,7 +90,9 @@ export interface CalendarJourney {
     handleFindSlotsForWaiting: (entry: CalendarWaitingEntry) => void;
     clearFindSlotsSeed: () => void;
     handleBookSlotFromFinder: (prefill: EditorPrefill) => void;
-    handleCreateAppointment: (draft: EditorDraft) => void;
+    /** Resolve only after the write is accepted. Reject with a safe,
+     * user-facing Error message to keep the editor open with its draft. */
+    handleCreateAppointment: (draft: EditorDraft) => void | Promise<void>;
     /**
      * Commit a new note on the patient's record. The HOST builds the
      * stored note — its id, its timestamp and its AUTHOR, who is the

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

@@ -136,6 +136,15 @@ export declare function formatDay(locale: string, value: Date | string): string;
  *  the platform popover's "(NN anni)" beside the patient's name. Pinned
  *  to `data.nowIso` so the figure never drifts under a test. */
 export declare function patientAgeYears(dobIso: string, data: CalendarData): number;
+/** Per-appointment capabilities from the host's canonical read. Omitted
+ * capabilities preserve the existing editor behaviour. Locked fields
+ * are omitted from drafts, so the host must preserve their stored values. */
+export interface CalendarEditorCapabilities {
+    editCare?: boolean;
+    editPatient?: boolean;
+    editDescription?: boolean;
+    editRecurrence?: boolean;
+}
 export interface EditorPrefill {
     /** Set = the editor EDITS this existing event; unset = create. */
     editEventId?: string;

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

@@ -22,6 +22,7 @@
  * the demos or the shared story shell.
  */
 import { type ReactNode } from 'react';
+import type { CalendarEditorCapabilities } from './calendar.model';
 import { type CalendarEvent } from '../../components/calendar';
 import { type NotesPanelNote, type NotesPanelProps, type NotesPanelSubmission } from '../../components/notes-panel';
 import { type ColorAssociation, type CalendarCarePlan, type CalendarAnamnesisAnswer, type CalendarOperatorGroup, type CalendarPatient, type CalendarWaitingEntry, type CalendarHistoryEntry, type CalendarSignChannel, type PatientRef } from './calendar.types';
@@ -145,9 +146,12 @@ export interface EditorPlatformOptions {
      *  reached from a prefill with `simpleSave: false` (audit C13). */
     onSaveAndReturn?: () => void;
 }
-export declare function AppointmentEditorPanel({ prefill, onSave, onDelete, onDuplicate, panelTitle, headerIcon, identity, after, closeOnSave, onDraftChange, slotPatch, colorAssociation, locale, scheduleByEntry, history, notes, onMove, onCopy, onWhatsApp, readOnly, platform, className, }: {
+export declare function AppointmentEditorPanel({ prefill, onSave, onDelete, onDuplicate, panelTitle, headerIcon, identity, after, closeOnSave, onDraftChange, slotPatch, colorAssociation, locale, scheduleByEntry, history, notes, onMove, onCopy, onWhatsApp, readOnly, capabilities, platform, className, }: {
     prefill?: EditorPrefill;
-    onSave: (draft: EditorDraft, extras?: EditorDraftExtras) => void;
+    capabilities?: CalendarEditorCapabilities;
+    /** The editor closes only after acceptance. A rejection leaves the
+     * draft intact and displays its safe, user-facing Error message. */
+    onSave: (draft: EditorDraft, extras?: EditorDraftExtras) => void | Promise<void>;
     /** Live composition feed — the grid mirrors the slot being filled as a
      *  draft placeholder while this panel is open. Emits `null` on unmount
      *  so the placeholder clears with the panel. */
@@ -297,15 +301,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[];

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,9 +1,10 @@
-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 type { CalendarAppointmentEditorSnapshot, CalendarAppointmentEditorLoader, } from './calendar-editor-hydration';
 export { SheetHostProvider, useSheetHost, type SheetHostContext, type SheetId, } from './calendar.host';
 export { CALENDAR_PREFERENCE_KEYS, memoryPreferenceAdapter, resetCalendarPreferences, usePersistedPreference, type CalendarPreferenceAdapter, } from './calendar.preferences';
-export { DEFAULT_DISPLAY, VIEW_OPTIONS, type AvailabilityContext, type BacklogFilter, type BacklogItem, type BacklogType, type CalendarFreeSlot, type CalendarRow, type CalendarSeries, type DisplaySettings, type DraftSlot, type EditorDraft, type EditorPrefill, type EditorRecurrence, type FindSlotsSeed, type HistoryInput, type PendingMove, type RailFocus, type RecurrenceFrequency, type SlotPatch, type ViewOption, type ViewOptionId, type WaitingEntryDraft, } from './calendar.model';
+export { DEFAULT_DISPLAY, VIEW_OPTIONS, type AvailabilityContext, type BacklogFilter, type BacklogItem, type BacklogType, type CalendarFreeSlot, type CalendarEditorCapabilities, type CalendarRow, type CalendarSeries, type DisplaySettings, type DraftSlot, type EditorDraft, type EditorPrefill, type EditorRecurrence, type FindSlotsSeed, type HistoryInput, type PendingMove, type RailFocus, type RecurrenceFrequency, type SlotPatch, type ViewOption, type ViewOptionId, type WaitingEntryDraft, } from './calendar.model';
 export { DEFAULT_WORKSPACE_DISPLAY, WORKSPACE_VIEWS, type ChairNameDisplay, type DeleteOptions, type EditorDraftExtras, type OperatorNameDisplay, type RecurringScope, type RequiredDocsSignMode, type WorkspaceDisplaySettings, type WorkspaceViewId, } from './calendar-workspace.model';
 export type { AssociationColorSources, CalendarAnamnesisAnswer, CalendarAppointmentMeta, CalendarBaseEvent, CalendarBookingContact, CalendarBranch, CalendarBusinessHours, CalendarCare, CalendarCareEntry, CalendarCareLink, CalendarCarePlan, CalendarCarePlanEntry, CalendarClosure, CalendarDayHours, CalendarHistoryEntry, CalendarHistoryField, CalendarHistoryKind, CalendarHoliday, CalendarOperatorFilterGroup, CalendarOperatorGroup, CalendarPatient, CalendarPhoneLabel, CalendarPhoneNumber, CalendarPractice, CalendarPracticeFeatures, CalendarPriceList, CalendarSignChannel, CalendarSignDocument, CalendarTaskDetail, CalendarWaitingEntry, CalendarWeeklyHours, CareDescriptionMode, ColorAssociation, } from './calendar.types';
 export type { CalendarEvent, CalendarEventStatus, CalendarResource, } from '../../components/calendar';

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-Dy4ZKtW0.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-k7BG8yIE.js";
 export {
   s as CALENDAR_PREFERENCE_KEYS,
   r as CalendarDataProvider,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfadocs/ui-kit",
-  "version": "1.25.0",
+  "version": "1.25.1-calendar.10",
   "type": "module",
   "description": "AlfaDocs shared design system — tokens, components, patterns, and translations for platform, booking, and alfascribe.",
   "license": "BUSL-1.1",
@@ -888,7 +888,8 @@
   },
   "publishConfig": {
     "access": "public",
-    "registry": "https://registry.npmjs.org/"
+    "registry": "https://registry.npmjs.org/",
+    "tag": "calendar-preview"
   },
   "engines": {
     "node": ">=22.6.0"