@alfadocs/ui-kit 1.47.1 → 1.48.0

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

@@ -22,9 +22,11 @@
  * the demos or the shared story shell.
  */
 import { type ReactNode } from 'react';
+import { AppointmentHistoryTimeline } from '../../components/appointment-details-panel/appointment-details-panel.history';
+import { IndicatorChips } from '../../components/appointment-details-panel/appointment-details-panel.identity';
 import type { CalendarEditorCapabilities } from './calendar.model';
 import type { CalendarEditorSeries } from './calendar-editor-hydration';
-import { type CalendarEvent, type CalendarResource } from '../../components/calendar';
+import { type CalendarResource } from '../../components/calendar';
 import { type NotesPanelNote, type NotesPanelProps, type NotesPanelSubmission, type AiConsentGate } 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';
 import { type CalendarData } from './calendar.data';
@@ -71,10 +73,19 @@ export interface PatientNotesSeam {
     onAddNote: (submission: NotesPanelSubmission) => void | Promise<void>;
     /** Replace a note's body: HTML for an HTML note, else plain text. */
     onEditNote: (noteId: string, content: string) => void | Promise<void>;
+    /** Called on the click that confirms it. Resolve once the delete has
+     *  landed; a rejection restores the row and the panel shows the message.
+     *  A clinical note is taken as kept, marked deleted, unless the note
+     *  says `keptOnDelete: false`: its row waits in place. */
     onDeleteNote: (noteId: string) => void | Promise<void>;
-    onTogglePin: (noteId: string) => void | Promise<void>;
-    /** Flag or unflag a note. Omitted → no flag control. */
-    onToggleFlag?: (noteId: string) => void | Promise<void>;
+    /** `next` is the value the note moves to. A rejection rolls the pin back
+     *  and the panel shows the message: do not also toast it. */
+    onTogglePin: (noteId: string, next: boolean) => void | Promise<void>;
+    /** As `onTogglePin`, for the flag. Omitted → no flag control. */
+    onToggleFlag?: (noteId: string, next: boolean) => void | Promise<void>;
+    /** Hears every refused save, delete, pin or flag. See `NotesPanel`'s
+     *  `onWriteError`: report only the ones with `shown: false`. */
+    onWriteError?: NotesPanelProps['onWriteError'];
     /** The practice's own drafting endpoint. Omitted → no AI affordance. */
     onRequestAiDraft?: NotesPanelProps['onRequestAiDraft'];
     /** The host's live transcription. Omitted → no microphone. */
@@ -142,7 +153,7 @@ declare function PatientNotesPanelContent({ patientId, seam, editable, currentNo
      * Whether this reader may write when `seam.writable` is absent: note
      * writes follow the notes, not `practice_appointment_edit`. False (or
      * no `seam`) leaves the composer, the pin, the in-place edit and the
-     * delete dialog unmounted.
+     * delete unmounted.
      */
     editable?: boolean;
     /** Address one note, exactly as `NotesPanel` does. */
@@ -165,13 +176,7 @@ export declare function PatientAppointmentsTimeline({ patientId, locale, }: {
     patientId: string;
     locale?: string;
 }): import("react/jsx-runtime").JSX.Element;
-/** The appointment's modification ledger as a kit Timeline, newest first,
- *  shared by the editor's History sub-view and the read-only details panel.
- *  An empty ledger shows the "No changes recorded" empty state. */
-export declare function AppointmentHistoryTimeline({ history, locale, }: {
-    history: readonly CalendarHistoryEntry[];
-    locale?: string;
-}): import("react/jsx-runtime").JSX.Element;
+export { AppointmentHistoryTimeline };
 export declare function PatientTasksPanel({ patientId }: {
     patientId: string;
 }): import("react/jsx-runtime").JSX.Element;
@@ -305,9 +310,7 @@ export declare function AppointmentEditorPanel({ prefill, onSave, onDelete, onDu
     /** Root class — a dialog host bounds the panel's height through it. */
     className?: string;
 }): import("react/jsx-runtime").JSX.Element;
-export declare function IndicatorChips({ event }: {
-    event: CalendarEvent;
-}): import("react/jsx-runtime").JSX.Element | null;
+export { IndicatorChips };
 export declare function AppointmentIdentity({ row, patientRef, showAge, onOpenPatient, anamnesisAnswers, }: {
     row: CalendarRow;
     /** Who this appointment is for: the id it carries and the record, when
@@ -538,5 +541,4 @@ export declare function FindFreeSlotsPanel({ rows, locale, seed, onBookSlot, onS
         to: Date;
     }) => void;
 }): import("react/jsx-runtime").JSX.Element;
-export {};
 //# sourceMappingURL=calendar.sheets.d.ts.map

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

@@ -11,25 +11,17 @@
  * Type names keep their `Demo*` prefix for now — a later sweep renames
  * them `Calendar*` in one go.
  */
-import type { CalendarEvent, CalendarEventStatus, CalendarResource } from '../../components/calendar';
+import type { CalendarEvent, CalendarResource } from '../../components/calendar';
 import type { CarePlanState } from '../../components/_shared/entity-card';
 import type { SignatureParty } from '../../components/signature-status-chip';
+import type { TaskEditorDraft, TaskEditorTask } from '../../components/task-editor';
+import type { AppointmentAnamnesisAnswer, AppointmentDetailsPatient, AppointmentHistoryEntry, AppointmentHistoryField, AppointmentHistoryKind, AppointmentPhoneLabel, AppointmentPhoneNumber, AppointmentSignChannel } from '../../components/appointment-details-panel';
 /** Platform `DoctorPatientPhoneNumber` carries a free-text label; the
- *  demo fixes the vocabulary so the printed call sheet can localise it. */
-export type CalendarPhoneLabel = 'mobile' | 'home' | 'work';
-export interface CalendarPhoneNumber {
-    label: CalendarPhoneLabel;
-    number: string;
-}
-/** One highlighted anamnesis answer, as the platform's details dialog
- *  lists it: the question, the Si/No, the free answer and the interview
- *  date. Texts are display strings — the host localises them. */
-export interface CalendarAnamnesisAnswer {
-    question: string;
-    yes: boolean;
-    answer?: string;
-    interviewIso: string;
-}
+ *  vocabulary is fixed so the printed call sheet can localise it. */
+export type CalendarPhoneLabel = AppointmentPhoneLabel;
+export type CalendarPhoneNumber = AppointmentPhoneNumber;
+/** One highlighted anamnesis answer (display strings, host-localised). */
+export type CalendarAnamnesisAnswer = AppointmentAnamnesisAnswer;
 /**
  * A patient as the HOST knows them. Only the identity — `id` and `name` —
  * is required: a host whose appointment feed carries a patient id and a
@@ -41,7 +33,7 @@ export interface CalendarAnamnesisAnswer {
  * a "Fiscal code" label is a claim about the record, not a blank. Omit the
  * row; where every row of a section would go, omit the section.
  */
-export interface CalendarPatient {
+export interface CalendarPatient extends AppointmentDetailsPatient {
     id: string;
     name: string;
     dobIso?: string;
@@ -237,7 +229,7 @@ export type CalendarCareLink = {
     }>;
 };
 /** Channel a signature request went out on (platform `requiredObjectsSignMode`). */
-export type CalendarSignChannel = 'sms' | 'email';
+export type CalendarSignChannel = AppointmentSignChannel;
 /** One document to sign on an appointment — each party's standing. */
 export interface CalendarSignDocument {
     id: string;
@@ -322,51 +314,14 @@ export interface CalendarBookingContact {
     /** When the booking was made (platform `createdAt`). */
     bookedAtIso: string;
 }
-/**
- * A calendar task (platform `DoctorReminder`) — the model the task editor
- * saves. A task has at most ONE counterpart: a patient, a company, an
- * operator, or none. `TaskType::validate()` refuses more than one with
- * "More than one counterpart is set", so the editor asks for one choice.
- * `note` is required here though the platform allows an empty one; `date`
- * is required on both sides. No title separate from the note, no priority,
- * no duration — the platform model has none.
- */
-export interface CalendarTask {
-    id: string;
-    /** An instant as an ISO 8601 string. The editor emits `toISOString()`,
-     *  so UTC with a `Z`; parse it with `new Date()`, never by slicing the
-     *  first 16 characters. A zone-less string on read is taken as local. */
-    dateIso: string;
-    /** The task text. Required here, though the platform allows an empty
-     *  one. */
-    note: string;
-    /** The clinician the task concerns: platform `doctorOperator`, filled
-     *  from `data.operators`. NOT the assignee (`assigneeId`), and mutually
-     *  exclusive with `patientId` and `companyId`. Absent = no operator. */
-    operatorId?: string;
-    /** Mutually exclusive with `companyId` and `operatorId`. */
-    patientId?: string;
-    /** Mutually exclusive with `patientId` and `operatorId` (platform
-     *  `doctorCompany`). */
-    companyId?: string;
-    /** Which kind of task — an OPAQUE token from `CalendarData.taskTypes`,
-     *  round-tripped untouched. The kit never parses it. Optional: a host
-     *  that supplies no `taskTypes` neither shows the field nor sends one. */
-    typeId?: string;
-    /** The practice USER the task is assigned to. Independent of the
-     *  counterpart above: an assigned task may still be about a patient. An
-     *  id from `CalendarData.taskAssignees`; absent = nobody. */
-    assigneeId?: string;
-    done: boolean;
-}
-/** The same shape without an identity — what the editor hands the create
- *  seam, and what an edit save re-sends in full (no partial patch).
- *  `done` is optional here (defaults to `false`) so a caller building a
- *  brand-new task never has to state the obvious; `CalendarTask.done` on
- *  a saved record stays required — a saved task always has a value. */
-export type TaskDraft = Omit<CalendarTask, 'id' | 'done'> & {
-    done?: boolean;
-};
+/** A calendar task (platform `DoctorReminder`): the calendar's name for the
+ *  published TaskEditor's record. See `TaskEditorTask` for every field,
+ *  including why `dateIso` is an instant and the one-counterpart rule. */
+export type CalendarTask = TaskEditorTask;
+/** The same shape without an identity: what the create seam receives and
+ *  what an edit save re-sends in full. See `TaskEditorDraft`. Published as
+ *  `CalendarTaskDraft`. */
+export type TaskDraft = TaskEditorDraft;
 /** One contiguous working range, minutes from local midnight. */
 export interface CalendarDayHours {
     startMin: number;
@@ -425,44 +380,13 @@ export interface CalendarWaitingEntry {
      *  when the host's `patientById` record carries no `avatarSrc`. */
     patientAvatarUrl?: string;
 }
-export type CalendarHistoryKind = 'created' | 'moved' | 'resized' | 'status' | 'edited' | 'deleted' | 'confirmedByPatient';
+export type CalendarHistoryKind = AppointmentHistoryKind;
 /** Form fields an edit can touch (the platform's audit vocabulary). */
-export type CalendarHistoryField = 'patient' | 'type' | 'care' | 'operator' | 'chair' | 'colour' | 'time' | 'duration';
-/** One ledger line — who did what to the appointment, and when. */
-export type CalendarHistoryEntry = {
-    id: string;
-    atIso: string;
-    actor: string;
-} & ({
-    kind: 'created';
-} | {
-    kind: 'moved';
-    fromIso: string;
-    toIso: string;
-} | {
-    kind: 'resized';
-    fromMin: number;
-    toMin: number;
-} | {
-    kind: 'status';
-    from: CalendarEventStatus;
-    to: CalendarEventStatus;
-} | {
-    kind: 'edited';
-    fields: CalendarHistoryField[];
-} | {
-    kind: 'deleted';
-}
-/** The patient confirmed by link; the host sends `actor: ''`. */
- | {
-    kind: 'confirmedByPatient';
-});
-/** Every labelled phone number — the single `phone` is the mobile when a
- *  patient carries no explicit list (platform prints each label: number).
- *  A patient the host supplied without either has no numbers to print,
- *  which is not the same as one labelled blank: the list comes back empty
- *  and the caller omits the block. */
-export declare function patientPhones(patient: CalendarPatient): CalendarPhoneNumber[];
+export type CalendarHistoryField = AppointmentHistoryField;
+/** One ledger line: who did what to the appointment, and when. */
+export type CalendarHistoryEntry = AppointmentHistoryEntry;
+/** Every labelled phone number; see the shared helper. */
+export { patientPhones } from '../../components/_shared/appointment-format';
 /**
  * A patient as the calendar can see them at one point: the id a row,
  * an event or a waiting entry carries, plus the record if the host's

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

@@ -1,4 +1,4 @@
-export { CalendarWorkspace, initialWorkspaceDisplay, WORKSPACE_TOOL, type CalendarWorkspaceProps, type CalendarOnlineBookings, type CalendarWorkspaceToolId, type CalendarWorkspaceAnalytics, type CalendarToolOpenSource, type CalendarDetailsOpenSource, } from './calendar-workspace';
+export { CalendarWorkspace, initialWorkspaceDisplay, WORKSPACE_TOOL, type CalendarWorkspaceProps, type CalendarOnlineBookings, type CalendarWorkspaceToolId, type CalendarWorkspaceExtraTool, type CalendarWorkspaceAnalytics, type CalendarToolOpenSource, type CalendarDetailsOpenSource, } from './calendar-workspace';
 export { CalendarDataProvider, useCalendarData, type CalendarData, type DayLoadState, } from './calendar.data';
 export type { CalendarJourney, CalendarOccurrenceMove, PatientNotesLoad, } from './calendar.journey';
 export type { CalendarAppointmentEditorSnapshot, CalendarAppointmentEditorLoader, CalendarEditorSeries, } from './calendar-editor-hydration';
@@ -8,9 +8,10 @@ export { SheetHostProvider, useSheetHost, type SheetHostContext, type SheetId, }
 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 CalendarEditorCapabilities, type CalendarRow, type CalendarSeries, type DisplaySettings, type DraftSlot, type EditorDraft, type EditorInitialFocus, 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 CalendarWaitingListState, 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, FreeSlotQuery, } from './calendar.types';
+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, CalendarTask, CalendarTaskDetail, CalendarWaitingEntry, CalendarWeeklyHours, CareDescriptionMode, ColorAssociation, FreeSlotQuery, TaskDraft as CalendarTaskDraft, } from './calendar.types';
 export type { CalendarEvent, CalendarEventStatus, CalendarResource, } from '../../components/calendar';
 export type { AppointmentItem } from '../../components/appointment-card';
-export type { NotesPanelNote, NotesPanelNoteActions, NotesPanelProps, NotesPanelSubmission, } from '../../components/notes-panel';
+export type { NotesPanelNote, NotesPanelNoteActions, NotesPanelProps, NotesPanelSubmission, NotesPanelWriteFailure, } from '../../components/notes-panel';
 export type { TasksPanelItem } from '../../components/tasks-panel';
+export type { ControlRoomTool } from '../../components/control-room-rail';
 //# sourceMappingURL=index.d.ts.map

package/dist/patterns/calendar/index.js

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

package/dist/patterns/help-me-write-templates/index.js

@@ -1,4 +1,4 @@
-import { A as s, a as t, b as r, H as i, c as p, u as l } from "../../_chunks/help-me-write-templates-DHIwa4xR.js";
+import { A as s, a as t, b as r, H as i, c as p, u as l } from "../../_chunks/help-me-write-templates-DQtT1qs_.js";
 export {
   s as AiCreditsExhaustedError,
   t as AiCreditsExhaustedNotice,

package/dist/patterns/marketplace-app-shell/index.js

@@ -1,4 +1,4 @@
-import { C as l, M as o } from "../../_chunks/marketplace-app-shell-PB89Dkk_.js";
+import { C as l, M as o } from "../../_chunks/marketplace-app-shell-Dehuxbi-.js";
 export {
   l as ConnectWithAlfadocs,
   o as MarketplaceAppShell

package/dist/patterns/payment-automation-upsell/index.js

@@ -1,4 +1,4 @@
-import { P as a } from "../../_chunks/payment-automation-upsell-BKmBXU4i.js";
+import { P as a } from "../../_chunks/payment-automation-upsell-ugi4np1l.js";
 export {
   a as PaymentAutomationUpsell
 };

package/dist/patterns/signature-request/index.js

@@ -1,4 +1,4 @@
-import { S as o } from "../../_chunks/signature-request-D_j2aQu1.js";
+import { S as o } from "../../_chunks/signature-request-15D363w5.js";
 export {
   o as SignatureRequestModal
 };