@alfadocs/ui-kit 1.13.0 → 1.15.0

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

@@ -0,0 +1,119 @@
+/**
+ * Calendar pattern — the JOURNEY contract: the domain state and every
+ * mutating handler the workspace, its panels and its surface consume
+ * (rows, cog display settings, grid focus, waiting list, modification
+ * history, signature requests, patient notes, the editor / Backlog /
+ * finder seeds, the draft-slot mirror, the goto seam and the
+ * availability projection).
+ * Transcribed member by member from the demo's `useCalendarJourneyState`
+ * so the host owns the implementation: the demos keep their fixture-backed
+ * hook, the platform island wires the same shape to `/internalApi/...`.
+ * No implementation lives here.
+ */
+import type { Dispatch, SetStateAction } from 'react';
+import type { NotesPanelNote, NotesPanelProps, NotesPanelSubmission } from '../../components/notes-panel';
+import type { AvailabilityContext, BacklogFilter, BacklogItem, CalendarFreeSlot, CalendarRow, DisplaySettings, DraftSlot, EditorDraft, EditorPrefill, FindSlotsSeed, HistoryInput, RailFocus, SlotPatch, WaitingEntryDraft } from './calendar.model';
+import type { CalendarHistoryEntry, CalendarSignChannel, CalendarWaitingEntry } from './calendar.types';
+export interface CalendarJourney {
+    rows: CalendarRow[];
+    setRows: Dispatch<SetStateAction<CalendarRow[]>>;
+    display: DisplaySettings;
+    setDisplay: Dispatch<SetStateAction<DisplaySettings>>;
+    focus: RailFocus;
+    setFocus: Dispatch<SetStateAction<RailFocus>>;
+    waitingList: CalendarWaitingEntry[];
+    /** A dialog host restores a removed entry from its Undo toast. */
+    setWaitingList: Dispatch<SetStateAction<CalendarWaitingEntry[]>>;
+    history: Record<string, CalendarHistoryEntry[]>;
+    /**
+     * The patient notes the host holds for this page load, by patient id.
+     * Seeded from `CalendarData.patientNotes(id)` and owned here after
+     * that, exactly like `history`: a patient absent from this map has
+     * not been written to yet and the panel falls back to the read model.
+     * The notes sub-view RENDERS this — it keeps no copy of its own — so
+     * an add, edit, delete or pin outlives the panel unmounting instead
+     * of being silently dropped.
+     */
+    notesByPatient: Record<string, NotesPanelNote[]>;
+    signRequests: Record<string, CalendarSignChannel>;
+    editorSeed: {
+        tick: number;
+        prefill?: EditorPrefill;
+    };
+    backlogSeed: {
+        tick: number;
+        type: BacklogFilter;
+    };
+    visibleRange: {
+        start: number;
+        end: number;
+    } | null;
+    backlogItems: BacklogItem[];
+    draftSlot: DraftSlot | null;
+    setDraftSlot: Dispatch<SetStateAction<DraftSlot | null>>;
+    slotPatch: SlotPatch | null;
+    gotoRequest: {
+        tick: number;
+        date: Date;
+    } | null;
+    availability: CalendarFreeSlot[] | null;
+    availabilityContext: AvailabilityContext | null;
+    findSlotsSeed: FindSlotsSeed | null;
+    logHistory: (eventId: string, entry: HistoryInput) => void;
+    handleRequestSignature: (eventId: string, channel: CalendarSignChannel) => void;
+    handleComposeNew: () => void;
+    handleScheduleWaiting: (entry: CalendarWaitingEntry) => void;
+    handleRemoveWaiting: (entry: CalendarWaitingEntry) => void;
+    handleUpsertWaiting: (draft: WaitingEntryDraft) => void;
+    handleConfirmAppointment: (eventId: string) => void;
+    handleOpenBacklog: (type: BacklogFilter) => void;
+    handleVisibleRangeChange: (range: {
+        start: number;
+        end: number;
+    }) => void;
+    handleDeleteAppointment: (eventId: string) => void;
+    handleDuplicateAppointment: (prefill: EditorPrefill) => void;
+    handleDraftMoved: (next: {
+        date: Date;
+        time: {
+            hours: number;
+            minutes: number;
+        };
+        chairId?: string;
+        operatorId?: string;
+    }) => void;
+    handleDraftResized: (durationMin: number) => void;
+    handleBookSlot: (prefill: EditorPrefill) => void;
+    handleShowAvailability: (slots: CalendarFreeSlot[] | null, fromDate?: Date, context?: AvailabilityContext) => void;
+    handleFocusEvent: (eventId: string) => void;
+    handleRevealAppointment: (eventId: string) => void;
+    handleFindSlotsForWaiting: (entry: CalendarWaitingEntry) => void;
+    clearFindSlotsSeed: () => void;
+    handleBookSlotFromFinder: (prefill: EditorPrefill) => void;
+    handleCreateAppointment: (draft: EditorDraft) => 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
+     * signed-in operator the host knows and the kit does not. The panel
+     * hands over only what was typed, so no name the kit invented can
+     * ever be attributed to a clinical note.
+     */
+    handleAddNote: (patientId: string, submission: NotesPanelSubmission) => void;
+    /** Replace a note's body with the text typed in the edit dialog. */
+    handleEditNote: (patientId: string, noteId: string, content: string) => void;
+    handleDeleteNote: (patientId: string, noteId: string) => void;
+    handleToggleNotePin: (patientId: string, noteId: string) => void;
+    /**
+     * The practice's OWN drafting endpoint, behind the composer's AI
+     * affordance. Omit it and the affordance is not offered: the kit
+     * ships no draft prose of its own, and must never put words it
+     * invented into a patient's record.
+     */
+    requestNoteAiDraft?: NotesPanelProps['onRequestAiDraft'];
+    /**
+     * The host's live transcription. Omit it and no microphone is
+     * offered — the kit transcribes nothing.
+     */
+    dictateNote?: NotesPanelProps['onDictate'];
+}
+//# sourceMappingURL=calendar.journey.d.ts.map