@alfadocs/ui-kit 1.47.1 → 1.49.0

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

@@ -6,9 +6,11 @@
  * Control Room rail docked inline-end — up to six tools, in strip
  * order: the upcoming Appointments panel (the rail's resting state and
  * its default), ONE appointment editor / details tool, the waiting list,
- * patient notes when in context, online bookings and the free-slot finder. Nothing else — no Inbox,
- * no Alia, no patient tabs, no care plan, no tasks. The panels are the
- * extracted modules from `calendar.sheets.tsx`; `calendar.host.ts`'s
+ * patient notes when in context, online bookings and the free-slot
+ * finder. The kit adds nothing else: no Inbox, no Alia, no patient tabs,
+ * no care plan, no tasks. A host may append its own tools after these
+ * (`extraTools`), which is how a host mounts TasksPanel. The panels are
+ * the extracted modules from `calendar.sheets.tsx`; `calendar.host.ts`'s
  * open / close seam maps onto the rail's dock, with `close()` returning
  * to the Appointments panel so no path leaves an empty rail.
  *
@@ -36,7 +38,7 @@
  * and care-plan cleanup and the Create-bill confirm.
  */
 import type { CalendarView } from '../../components/calendar';
-import { type ControlRoomFavoriteChange } from '../../components/control-room-rail';
+import { type ControlRoomFavoriteChange, type ControlRoomTool } from '../../components/control-room-rail';
 import { type CalendarAppointmentEditorLoader } from './calendar-editor-hydration';
 import { type CalendarAppointmentDetailsLoader } from './calendar-appointment-details';
 import { type CalendarData } from './calendar.data';
@@ -64,13 +66,47 @@ export type CalendarToolOpenSource = 'rail' | 'appointment_panel' | 'selection'
 /** Where the appointment behind a details panel was selected. `host` is
  *  a selection the journey made itself. */
 export type CalendarDetailsOpenSource = 'calendar' | 'appointments_panel' | 'bookings_panel' | 'waiting_list' | 'deep_link' | 'host';
+/**
+ * A host tool on the workspace rail (`CalendarWorkspaceProps.extraTools`):
+ * a Control Room tool, plus what privacy mode does to it. `scope` and
+ * `reorderable` are ignored: the workspace rail orders by favourites.
+ */
+export interface CalendarWorkspaceExtraTool extends ControlRoomTool {
+    /**
+     * What privacy mode does to this tool's panel. The kit cannot see what
+     * the panel shows, so the default is the safe one.
+     *
+     * - `'withhold'` (default): while privacy mode is on, the panel and its
+     *   `header` are replaced by the privacy notice, titled with `label` and
+     *   offering "Turn off privacy mode". The host's panel is unmounted until
+     *   privacy is turned off. The strip button and `badgeCount` stay.
+     * - `'host'`: the panel stays mounted and the host masks it, reading the
+     *   mode from `onPrivacyChange` (a task list sets `linkedLabelMasked`;
+     *   mind free-text titles, which the grid hides under privacy).
+     *   Also the right value for a panel that shows no patient data at all.
+     *   The kit cannot check either claim.
+     */
+    privacy?: 'withhold' | 'host';
+    /**
+     * Keeps this tool docked while it is open and `hold` is true: a click on
+     * the grid (a card, a card with no patient, an empty slot) then changes
+     * the selection but docks nothing over the panel, neither the details nor
+     * the editor. Set it while the panel holds unsaved input, such as an open
+     * task editor. Explicit requests still open another tool: the strip, the
+     * toolbar, a free band's Book, a slot picked in an armed placement, and
+     * the host. Once released, a click on the card docks its details.
+     */
+    hold?: boolean;
+}
 /**
  * Usage callbacks for the host's analytics. The kit raises no event of
  * its own and passes identifiers only, never patient data: the host owns
  * the calls, the property allow-list and any once-per guard.
  */
 export interface CalendarWorkspaceAnalytics {
-    /** A tool panel opened. Not raised again while it stays open. */
+    /** A built-in tool panel opened. Not raised again while it stays open,
+     *  and never for an id no tool carries. Host tools report through
+     *  `onExtraToolOpen` instead. */
     onToolOpen?: (event: {
         toolId: CalendarWorkspaceToolId;
         source: CalendarToolOpenSource;
@@ -90,12 +126,23 @@ export interface CalendarWorkspaceAnalytics {
         source: CalendarDetailsOpenSource;
         view: CalendarView;
     }) => void;
-    /** A rail preference was saved on this device. `resize` is raised only
-     *  with `persistPanelWidthKey`, since without it nothing is saved. */
+    /** A rail preference was saved on this device. `toolId` may be a host
+     *  tool's id. `resize` is raised only with `persistPanelWidthKey`, since
+     *  without it nothing is saved. */
     onToolPreferencesChange?: (event: {
         action: ControlRoomFavoriteChange['action'] | 'resize';
         toolId: string;
     }) => void;
+    /**
+     * A host tool's panel opened (`extraTools`). Not raised again while it
+     * stays open. `rail` is a pick on the strip; `system` is any other open
+     * (the host's own `useControlRoomActions().openTool`, an agent).
+     */
+    onExtraToolOpen?: (event: {
+        toolId: string;
+        source: Extract<CalendarToolOpenSource, 'rail' | 'system'>;
+        view: CalendarView;
+    }) => void;
 }
 export interface CalendarWorkspaceProps {
     /** Optional canonical read for every existing-appointment editor route.
@@ -105,7 +152,9 @@ export interface CalendarWorkspaceProps {
     loadAppointmentEditor?: CalendarAppointmentEditorLoader;
     /** The host's read for the read-only appointment details panel (P-C3).
      * With it a selection docks that panel, Edit opens the editor and a save
-     * re-reads the details; without it details stays the editor form. */
+     * re-reads the details; without it details stays the editor form. Keep
+     * it stable: passing a new function re-reads the open details panel,
+     * which is how a host shows a change made outside the panel. */
     loadAppointmentDetails?: CalendarAppointmentDetailsLoader;
     /** The domain state and its handlers — the host implements them. */
     journey: CalendarJourney;
@@ -219,6 +268,38 @@ export interface CalendarWorkspaceProps {
     /** Usage callbacks for the host's analytics. Omit it and nothing is
      *  reported. */
     analytics?: CalendarWorkspaceAnalytics;
+    /**
+     * Host tools, appended to the rail after the built-in ones, in this
+     * order. A tool is offered by passing it and withheld by leaving it out:
+     * `availableTools` narrows the built-in tools only.
+     *
+     * Ids: every `WORKSPACE_TOOL` id is reserved, even for a tool
+     * `availableTools` withholds, and a tool using one is left off the rail.
+     * A repeated id keeps its first tool. Nothing throws. The kit's own
+     * Storybook and tests warn; the published build drops the tool silently.
+     *
+     * The panel renders inside the workspace, so the host's own providers
+     * reach it. It unmounts when another tool opens, so keep state that must
+     * survive in the host. Render a kit `PanelHeader` first and the rail puts
+     * its favourite and close controls in it. Opening one reports through
+     * `analytics.onExtraToolOpen`. The workspace passes no permission to host
+     * tools. Only the strip, an agent and code inside an open panel
+     * (`useControlRoomActions`) open a tool: code outside the workspace
+     * cannot, since the workspace owns its rail provider. If the host stops
+     * passing the open tool, the rail docks the Appointments panel. Memoise
+     * the array: a new one re-registers the rail.
+     */
+    extraTools?: readonly CalendarWorkspaceExtraTool[];
+    /**
+     * Raised when privacy mode turns on or off, from the toolbar toggle or a
+     * withheld panel's "Turn off privacy mode". Observe-only: the workspace
+     * owns the flag, it starts off on every mount (not reported) and is
+     * never persisted. Unmounting with privacy on reports `false`, so the
+     * host's copy never outlives the workspace. Raised in the same handler,
+     * so a host that sets state here renders its masked tool in the same
+     * commit as the masked grid.
+     */
+    onPrivacyChange?: (privacy: boolean) => void;
 }
 /**
  * The cog's settings as the workspace opens with them: the remembered

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

@@ -35,6 +35,22 @@ export declare const ALL_WORKSPACE_TOOLS: readonly CalendarWorkspaceToolId[];
  * kit it mounts must not crash the agenda.
  */
 export declare function resolveAvailableTools(requested: readonly string[]): ReadonlySet<CalendarWorkspaceToolId>;
+/** Whether `id` is one of the built-in rail tools. */
+export declare function isWorkspaceToolId(id: string): id is CalendarWorkspaceToolId;
+/** Why a host tool was left off the rail. */
+export type ExtraToolRejection = 'reserved' | 'duplicate' | 'empty';
+/** The host tools the rail can carry, in the host's order. Built-in ids are
+ *  reserved even when withheld, a repeated id keeps its first tool, an empty
+ *  id is dropped, and nothing throws: a host mistake must not sink the page. */
+export declare function resolveExtraTools<T extends {
+    readonly id: string;
+}>(requested: readonly T[]): {
+    tools: T[];
+    rejected: {
+        id: string;
+        reason: ExtraToolRejection;
+    }[];
+};
 /** The platform's four ranges; "Working week" became the Show-weekends
  *  item, so it is no longer a view of its own. */
 export type WorkspaceViewId = 'day' | 'threeDays' | 'week' | 'month';
@@ -207,18 +223,7 @@ export declare function signChannelStates(ref: PatientRef): {
  *  email, else nothing. "Can take one" is `ready` alone — a channel we
  *  know nothing about is not a channel to send on by default. */
 export declare function defaultSignMode(ref: PatientRef): RequiredDocsSignMode;
-/** The patient's address as one line — the map link's search text, and
- *  the link's own label. Empty when the host supplied no address at all,
- *  which is the caller's signal to leave the map row out rather than
- *  offer a search for nothing. */
-export declare function patientAddressLine(patient: CalendarPatient): string;
-/** The map link's own LABEL — street and city, the pair the popover has
- *  always printed. The postcode belongs in the search query, not in the
- *  visible text, so widening `patientAddressLine` for the URL must not
- *  drag the label along with it. */
-export declare function patientAddressLabel(patient: CalendarPatient): string;
-/** Google Maps search for the patient's address — the popover's map link. */
-export declare function patientMapsUrl(patient: CalendarPatient): string;
+export { patientAddressLabel, patientAddressLine, patientMapsUrl, } from '../../components/_shared/appointment-format';
 /** A CREATE mode armed by a deep link (`createParameters`) or the
  *  Backlog's Schedule: the next empty-slot click opens the editor with
  *  this context already filled in (platform `_switchMode('create')`). */

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

@@ -12,7 +12,7 @@
  */
 import type { CalendarEventStatus } from '../../components/calendar';
 import type { Dispatch, SetStateAction } from 'react';
-import type { NotesPanelNote, NotesPanelProps, NotesPanelSubmission, AiConsentGate } from '../../components/notes-panel';
+import type { NotesPanelNote, NotesPanelProps, NotesPanelSubmission, NotesPanelWriteFailure, AiConsentGate } from '../../components/notes-panel';
 import type { PatientNotesSeam } from './calendar.sheets';
 import type { AvailabilityContext, BacklogFilter, BacklogItem, CalendarFreeSlot, CalendarRow, DisplaySettings, DraftSlot, EditorDraft, EditorPrefill, FindSlotsSeed, HistoryInput, RailFocus, SlotPatch, WaitingEntryDraft } from './calendar.model';
 import type { DeleteOptions, EditorDraftExtras, RecurringScope } from './calendar-workspace.model';
@@ -171,16 +171,50 @@ export interface CalendarJourney {
      * 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.
+     * ever be attributed to a clinical note. Reject with a translated
+     * Error: the draft stays in the composer with the message while the
+     * Notes tool is open, and `handleNoteWriteError` hears a refusal that
+     * lands after the reader left it.
      */
     handleAddNote: (patientId: string, submission: NotesPanelSubmission) => void | Promise<void>;
     /** Replace a note's body: HTML for an HTML note, else plain text. A
-     *  rejected write keeps the draft or dialog open with its message. */
+     *  rejected write keeps the draft in the composer with its message, as
+     *  `handleAddNote` does. */
     handleEditNote: (patientId: string, noteId: string, content: string) => void | Promise<void>;
+    /**
+     * Delete a note. Called on the click that confirms it. Resolve once the
+     * delete has landed. A rejection brings the row back and the notes
+     * panel shows the error's message, so reject with a translated Error
+     * and do not also toast it.
+     *
+     * A clinical note is taken as kept for the record: its row waits in
+     * place, paused, until `notesByPatient` marks it `deleted`. Any other
+     * note fades and stays hidden until `notesByPatient` drops it. Set
+     * `keptOnDelete` on a note to say otherwise. The panel holds this only
+     * while the Notes tool stays open for that patient: reopened, it shows
+     * the note as `notesByPatient` does, with a live delete. So return the
+     * same promise for a second delete of a note already being deleted.
+     */
     handleDeleteNote: (patientId: string, noteId: string) => void | Promise<void>;
-    handleToggleNotePin: (patientId: string, noteId: string) => void | Promise<void>;
-    /** Flag or unflag a note. Omit it and the flag control is not offered. */
-    handleToggleNoteFlag?: (patientId: string, noteId: string) => void | Promise<void>;
+    /**
+     * Pin or unpin a note. `next` is the value the note moves to, so set it
+     * rather than flipping what you hold. A returned promise holds the new
+     * value until the notes agree; a rejection rolls it back and the notes
+     * panel shows the message. Do not also toast it.
+     */
+    handleToggleNotePin: (patientId: string, noteId: string, next: boolean) => void | Promise<void>;
+    /** As `handleToggleNotePin`, for the flag. Omit it and the flag control
+     *  is not offered. */
+    handleToggleNoteFlag?: (patientId: string, noteId: string, next: boolean) => void | Promise<void>;
+    /**
+     * Hears every refused note write: a save, a delete, a pin or a flag.
+     * `failure.shown` says whether the notes panel told the reader. Toast
+     * only the ones with `shown: false`, for example a refusal that arrives
+     * after the reader switched tool or patient; a save among them has lost
+     * its draft. Wire it in the same change that stops you toasting every
+     * refusal yourself: without it, those late refusals reach no one.
+     */
+    handleNoteWriteError?: (patientId: string, failure: NotesPanelWriteFailure) => void;
     /** Read a patient's notes: the latest few, or every note. */
     handleLoadNotes?: (patientId: string, scope: 'preview' | 'all') => void;
     /**

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

@@ -9,9 +9,11 @@
  * — the host supplies it, the model never reaches for a module global.
  */
 import type { TFunction } from 'i18next';
-import { ThumbsUp } from 'lucide-react';
 import { type CalendarEvent, type CalendarEventStatus, type CalendarResource } from '../../components/calendar';
 import type { WorkflowStatusTone } from '../../components/workflow-status';
+import { APPOINTMENT_STATE_WORKFLOW } from '../../components/_shared/entity-card';
+import { APPOINTMENT_STATUS_BADGE_VARIANT } from '../../components/appointment-details-panel/appointment-details-panel.identity';
+import type { AppointmentRecurrenceFrequency } from '../../components/appointment-details-panel';
 import type { CalendarData } from './calendar.data';
 import { type CareDescriptionMode, type ColorAssociation, type CalendarBaseEvent, type CalendarBookingContact, type CalendarCareEntry, type CalendarCareLink, type CalendarClosure, type CalendarDayHours, type CalendarHistoryEntry, type CalendarPatient, type CalendarPhoneNumber, type CalendarSignDocument, type CalendarWaitingEntry, type CatalogueState, type PatientRef } from './calendar.types';
 export declare const STATUS_UI_KEY: Record<CalendarEventStatus, string>;
@@ -131,8 +133,7 @@ export declare const DAY_WINDOWS: Record<DisplaySettings['window'], {
     min: string;
     max: string;
 }>;
-export declare function formatTimeRange(locale: string, start: Date | string, end?: Date | string): string;
-export declare function formatDay(locale: string, value: Date | string): string;
+export { DETAIL_STAMP_FORMAT, formatDay, formatTimeRange, parseEventDate, RECURRENCE_LABEL_KEY, sortHistoryNewestFirst, } from '../../components/_shared/appointment-format';
 /** Completed years between a birth date and the practice's fixed "now" —
  *  the platform popover's "(NN anni)" beside the patient's name. Pinned
  *  to `data.nowIso` so the figure never drifts under a test. */
@@ -197,13 +198,11 @@ export interface EditorPrefill {
     isTask?: boolean;
 }
 /** Platform's six `recurrence_frequency` values, in its dropdown order. */
-export type RecurrenceFrequency = 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'semiannual' | 'yearly';
+export type RecurrenceFrequency = AppointmentRecurrenceFrequency;
 /** Repetition cap — platform asserts 2..100 on the entity. */
 export declare const RECURRENCE_MAX_COUNT = 100;
 /** Dropdown order, matching the platform modal's own. */
 export declare const RECURRENCE_FREQUENCIES: readonly RecurrenceFrequency[];
-/** Literal map (not a template) so key extractors see every key. */
-export declare const RECURRENCE_LABEL_KEY: Record<RecurrenceFrequency, string>;
 export interface EditorRecurrence {
     frequency: RecurrenceFrequency;
     /** Count XOR until — the exclusivity `DoctorAppointment` enforces. */
@@ -355,12 +354,8 @@ export declare function deriveCareLinkDefaults(link: CalendarCareLink | undefine
 export type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
 /** A ledger line before the journey stamps id, time and actor onto it. */
 export type HistoryInput = DistributiveOmit<CalendarHistoryEntry, 'id' | 'atIso' | 'actor'>;
-/** Absolute stamp for booked-at and ledger lines — day and time. */
-export declare const DETAIL_STAMP_FORMAT: Intl.DateTimeFormatOptions;
 /** Live stamps advance from the practice clock, never the real one. */
 export declare function historyStampIso(seq: number, data: CalendarData): string;
-/** Timeline 'newest-first' is a plain column — DOM order must already be. */
-export declare function sortHistoryNewestFirst(entries: readonly CalendarHistoryEntry[]): CalendarHistoryEntry[];
 /** Documents still awaiting a required party (the chip's own rule). */
 export declare function signingSummary(docs: readonly CalendarSignDocument[]): {
     toSign: number;
@@ -399,11 +394,12 @@ export declare function priceListState(data: CalendarData): CatalogueState;
  *  list the practice does not have, and `priceLists[0].id` on an empty
  *  catalogue threw and took the whole calendar down with it. */
 export declare function priceListIdFor(patientId: string | undefined, data: CalendarData): string | undefined;
-export declare const STATUS_CHIP: Record<CalendarEventStatus, {
-    variant: 'success' | 'info' | 'warning' | 'error' | 'accentSoft';
+type StatusChip = {
+    variant: (typeof APPOINTMENT_STATUS_BADGE_VARIANT)[CalendarEventStatus];
     tone: WorkflowStatusTone;
-    Icon: typeof ThumbsUp;
-}>;
+    Icon: (typeof APPOINTMENT_STATE_WORKFLOW)[CalendarEventStatus]['Icon'];
+};
+export declare const STATUS_CHIP: Record<CalendarEventStatus, StatusChip>;
 export type BacklogType = 'booking' | 'waiting' | 'unconfirmed' | 'noOperator' | 'signature';
 /** The filter strip's segments — every type, or all of them grouped. */
 export type BacklogFilter = BacklogType | 'all';
@@ -668,9 +664,6 @@ export interface PrintSheetInput {
     visibleOperatorIds: string[];
     privacy: boolean;
 }
-/** A date-only start (all-day rows) is already a local day; anything
- *  else parses as the wall clock the fixtures and the editor write. */
-export declare function parseEventDate(value: string | Date): Date;
 /** The title privacy mode shows. TOTAL in the masked branch: a host
  *  that supplies an EMPTY `privacyModeTitle` gets the bullets, never a
  *  blank and never a fallback that would leak what we do or do not hold

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

@@ -3,7 +3,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';
 import type { CalendarOccurrenceMove } from './calendar.journey';
-export declare function CalendarSurface({ rows, setRows, onFocus, locale, onComposeNew, onComposeTask, onOpenWaitingList, onAddWaitingEntry, onOpenOnlineBookings, onlineBookingsCount, waitingBadgeCount, onVisibleRangeChange, selectedEventId, gotoRequest, onBookSlot, onBookSlotFromFinder, display, setDisplay, onHistory, readOnly, reviewOnlyEventIds, detailsOnEveryClick, placement, onPlacementEnd, createMode, onCreateModeEnd, focusScroll, saveNotice, privacy, onPrivacyChange, availability, availabilityContext, availableTools, schedulerLicenseKey, id, preferences, onMoveOccurrence, onViewChange, onPeekOpen, }: {
+export declare function CalendarSurface({ rows, setRows, onFocus, locale, onComposeNew, onComposeTask, onOpenWaitingList, onAddWaitingEntry, onOpenOnlineBookings, onlineBookingsCount, waitingBadgeCount, onVisibleRangeChange, selectedEventId, gotoRequest, onBookSlot, onBookSlotFromFinder, display, setDisplay, onHistory, readOnly, reviewOnlyEventIds, detailsOnEveryClick, gridHeld, placement, onPlacementEnd, createMode, onCreateModeEnd, focusScroll, saveNotice, privacy, onPrivacyChange, availability, availabilityContext, availableTools, schedulerLicenseKey, id, preferences, onMoveOccurrence, onViewChange, onPeekOpen, }: {
     rows: CalendarRow[];
     setRows: React.Dispatch<React.SetStateAction<CalendarRow[]>>;
     onFocus: (focus: RailFocus) => void;
@@ -69,6 +69,9 @@ export declare function CalendarSurface({ rows, setRows, onFocus, locale, onComp
     } | null;
     /** Seed the editor prefilled (an empty-slot click, a booking to process). */
     onBookSlot: (prefill: EditorPrefill) => void;
+    /** A host tool holds the dock (`hold`): a grid click still selects, but
+     *  never opens the editor over it. */
+    gridHeld?: boolean;
     onBookSlotFromFinder: (prefill: EditorPrefill) => void;
     /** The cog's settings — owned by the journey (the editor reads them). */
     display: WorkspaceDisplaySettings;

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-C_eXL1by.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,