@alfadocs/ui-kit-debug 1.12.6 → 1.14.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

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

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.journey.d.ts","sourceRoot":"","sources":["../../../src/patterns/calendar/calendar.journey.ts"],"names":[],"mappings":"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"}