@alfadocs/ui-kit 1.30.0 → 1.32.0

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

@@ -1,7 +1,8 @@
 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, }: {
+import type { CalendarOccurrenceMove } from './calendar.journey';
+export declare function CalendarSurface({ rows, setRows, onFocus, locale, onComposeNew, 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, }: {
     rows: CalendarRow[];
     setRows: React.Dispatch<React.SetStateAction<CalendarRow[]>>;
     onFocus: (focus: RailFocus) => void;
@@ -11,11 +12,16 @@ export declare function CalendarSurface({ rows, setRows, onFocus, locale, onComp
     privacy: boolean;
     onPrivacyChange: (next: boolean) => void;
     /** The finder's live projection: free ranges glow, booked cards dim,
-     *  and a click inside a range books it. Null when no search is shown. */
+     *  and a band opens its original choices. Null when no search is shown. */
     availability: CalendarFreeSlot[] | null;
     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>;
+    /** The host reads its own details: every row click focuses, including
+     *  patient-less and pending rows. Off, a pending chip stays inert. */
+    detailsOnEveryClick?: boolean;
     /** 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;
@@ -57,6 +63,7 @@ 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;
+    onBookSlotFromFinder: (prefill: EditorPrefill) => void;
     /** The cog's settings — owned by the journey (the editor reads them). */
     display: WorkspaceDisplaySettings;
     setDisplay: React.Dispatch<React.SetStateAction<WorkspaceDisplaySettings>>;
@@ -81,5 +88,8 @@ export declare function CalendarSurface({ rows, setRows, onFocus, locale, onComp
     /** Where the toolbar's remembered choices live — the host's per-user
      *  store. Defaults to the session-scoped in-memory adapter. */
     preferences?: CalendarPreferenceAdapter;
+    /** The host's series move (S-C8). With it, a recurring parent's move
+     *  always confirms, asks the scope and hides the notify boxes. */
+    onMoveOccurrence?: (move: CalendarOccurrenceMove) => Promise<void>;
 }): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=calendar.surface.d.ts.map

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

@@ -372,7 +372,7 @@ export interface CalendarWaitingEntry {
     /** Story-only: the patient's number can receive WhatsApp messages. */
     whatsappCapable?: boolean;
 }
-export type CalendarHistoryKind = 'created' | 'moved' | 'resized' | 'status' | 'edited' | 'deleted';
+export type CalendarHistoryKind = 'created' | 'moved' | 'resized' | 'status' | 'edited' | 'deleted' | 'confirmedByPatient';
 /** 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. */
@@ -399,6 +399,10 @@ export type CalendarHistoryEntry = {
     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).
@@ -492,4 +496,28 @@ export interface CalendarBranch {
     /** Display name — the host localises it. */
     name: string;
 }
+/**
+ * One free-slot question for a host that answers SERVER-side
+ * (`CalendarData.searchFreeSlots`). The scope is already narrowed to what
+ * the chosen care makes eligible, so the host asks its own finder for
+ * exactly this and nothing wider. `from` / `to` are local wall-clock
+ * instants. The STEP is the host's — the kit names none, so the server
+ * answers on whatever grid the practice's calendar interval implies.
+ */
+export interface FreeSlotQuery {
+    /** Search from here — clamped to midnight of the host's `nowIso` day. */
+    from: Date;
+    /** Last date to look at (inclusive). */
+    to: Date;
+    /** The appointment length the answer must fit. */
+    durationMin: number;
+    /** Operator ids in scope — never empty. */
+    operatorIds: readonly string[];
+    /** Chair ids in scope — never empty. */
+    chairIds: readonly string[];
+    /** The care the search was scoped to, when one was chosen. */
+    careId?: string;
+    /** The host's own medical-device strings, round-tripped untouched. */
+    medicalDeviceIds?: readonly string[];
+}
 //# sourceMappingURL=calendar.types.d.ts.map

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

@@ -1,13 +1,16 @@
-export { CalendarWorkspace, initialWorkspaceDisplay, WORKSPACE_TOOL, type CalendarWorkspaceProps, type CalendarWorkspaceToolId, } from './calendar-workspace';
-export { CalendarDataProvider, useCalendarData, type CalendarData, } from './calendar.data';
-export type { CalendarJourney } from './calendar.journey';
+export { CalendarWorkspace, initialWorkspaceDisplay, WORKSPACE_TOOL, type CalendarWorkspaceProps, type CalendarOnlineBookings, type CalendarWorkspaceToolId, } 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';
+export type { CalendarAppointmentDetails, CalendarDocumentKind, CalendarAppointmentDetailsLoader, CalendarAppointmentDetailsSnapshot, } from './calendar-appointment-details';
+export { CalendarSeriesScopeChooser, type CalendarSeriesScopeChooserProps, } from './calendar-series-scope-chooser';
 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 { 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 { CalendarEvent, CalendarEventStatus, CalendarResource, } from '../../components/calendar';
 export type { AppointmentItem } from '../../components/appointment-card';
-export type { NotesPanelNote, NotesPanelProps, NotesPanelSubmission, } from '../../components/notes-panel';
+export type { NotesPanelNote, NotesPanelNoteActions, NotesPanelProps, NotesPanelSubmission, } from '../../components/notes-panel';
 export type { TasksPanelItem } from '../../components/tasks-panel';
 //# sourceMappingURL=index.d.ts.map

package/dist/patterns/calendar/index.js

@@ -1,19 +1,20 @@
-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-a84AHQwj.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-BX-zDyVR.js";
 export {
   s as CALENDAR_PREFERENCE_KEYS,
   r as CalendarDataProvider,
-  E as CalendarWorkspace,
-  P as DEFAULT_DISPLAY,
-  t as DEFAULT_WORKSPACE_DISPLAY,
-  S as SheetHostProvider,
-  A as VIEW_OPTIONS,
-  C as WORKSPACE_TOOL,
-  d as WORKSPACE_VIEWS,
-  o as initialWorkspaceDisplay,
-  D as memoryPreferenceAdapter,
-  i as resetCalendarPreferences,
-  n as useCalendarData,
-  W as usePersistedPreference,
-  _ as useSheetHost
+  E as CalendarSeriesScopeChooser,
+  P as CalendarWorkspace,
+  S as DEFAULT_DISPLAY,
+  o as DEFAULT_WORKSPACE_DISPLAY,
+  C as SheetHostProvider,
+  t as VIEW_OPTIONS,
+  d as WORKSPACE_TOOL,
+  A as WORKSPACE_VIEWS,
+  i as initialWorkspaceDisplay,
+  n as memoryPreferenceAdapter,
+  D as resetCalendarPreferences,
+  W as useCalendarData,
+  _ as usePersistedPreference,
+  c as useSheetHost
 };
 //# sourceMappingURL=index.js.map

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

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

package/dist/patterns/signature-request/channel-meta.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Channel labels and icons shared by the request form and the signatures
+ * list, so a channel reads the same in both views.
+ */
+import type { ReactNode } from 'react';
+/**
+ * Delivery channel for one signer's signature request. `'qr'` means the
+ * signer scans a QR code that the dialog shows in its QR step after the
+ * request (see `qrCodes`). Every patient-side signer is offered `'qr'`
+ * unless their `availableChannels` leaves it out; the operator never is.
+ */
+export type SignatureChannel = 'sms' | 'email' | 'whatsapp' | 'on-device' | 'qr';
+/**
+ * Delivery channel for an operator's counter-sign request. The default is
+ * system defined: the operator's own `defaultChannel` arrives preselected.
+ */
+export type OperatorChannel = 'sms' | 'email' | 'on-device';
+/** Operator channel display order. */
+export declare const OPERATOR_CHANNELS: readonly OperatorChannel[];
+export type ChannelMeta = Record<SignatureChannel, {
+    /** The label: the list's text and the channel dropdown's option. */
+    label: string;
+    icon: ReactNode;
+}>;
+/** Translated labels and decorative icon for every channel. */
+export declare function useChannelMeta(): ChannelMeta;
+//# sourceMappingURL=channel-meta.d.ts.map

package/dist/patterns/signature-request/index.d.ts

@@ -1,3 +1,3 @@
 export { SignatureRequestModal } from './signature-request';
-export type { SignatureRequestModalProps, SignatureRequestSubmission, SignerRequest, SignerOption, SignatureChannel, OperatorChannel, } from './signature-request';
+export type { SignatureRequestModalProps, SignatureRequestSubmission, SignatureQrCode, SignerRequest, SignerOption, OperatorOption, SignatureChannel, OperatorChannel, SignatureChannelDraft, SignatureChannelResolution, SignatureRecord, SignatureLegalLevel, SignatureDownloadVersion, SignatureShareTarget, RequiredSignatureItem, RequiredSignatureItemKind, SignatureRequestOutcome, } from './signature-request';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,4 +1,4 @@
-import { S as o } from "../../_chunks/signature-request-C-IsbkPf.js";
+import { S as o } from "../../_chunks/signature-request-vihDT8On.js";
 export {
   o as SignatureRequestModal
 };

package/dist/patterns/signature-request/load-status.d.ts

@@ -0,0 +1,13 @@
+export interface LoadStatusProps {
+    loading: boolean;
+    loadingText: string;
+    /** Said once when loading ends. Nothing is said if it never loaded. */
+    loadedText: string;
+    /**
+     * Another message for the same region, e.g. that a row was deleted. It
+     * wins while set and not loading; `''` empties the region.
+     */
+    message?: string;
+}
+export declare function LoadStatus({ loading, loadingText, loadedText, message: override, }: LoadStatusProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=load-status.d.ts.map

package/dist/patterns/signature-request/person-grid.d.ts

@@ -0,0 +1,32 @@
+import type { ChannelMeta } from './channel-meta';
+export declare const PERSON_GRID = "ds:grid ds:grid-cols-[var(--spacing-xl)_minmax(0,1fr)_var(--min-target-size)] ds:@[512px]/person:grid-cols-[var(--spacing-xl)_minmax(0,1fr)_max-content_var(--min-target-size)] ds:items-center ds:gap-x-[var(--spacing-sm)] ds:gap-y-[var(--spacing-sm)]";
+export declare const PERSON_AVATAR = "ds:col-start-1 ds:row-start-1 ds:flex ds:items-center ds:justify-center";
+/** The name select, in a row that also has a channel select. */
+export declare const PERSON_NAME = "ds:col-start-2 ds:row-start-1 ds:min-w-0";
+/** The name select, in a row with no channel: it takes the channel's width. */
+export declare const PERSON_NAME_FULL = "ds:col-[2/-2] ds:row-start-1 ds:min-w-0";
+/**
+ * The channel select: beside the name when wide, under it when narrow.
+ * `-3/-2` is the name column in the 3-column grid and the channel column in
+ * the 4-column one.
+ */
+export declare const PERSON_CHANNEL = "ds:col-[-3/-2] ds:row-start-2 ds:min-w-0 ds:@[512px]/person:row-start-1";
+export declare const PERSON_ACTION = "ds:col-[-2/-1] ds:row-start-1 ds:flex ds:items-center ds:justify-center";
+/** Rows under a person (OTP switch, notes, errors): name to channel edge. */
+export declare const PERSON_UNDER = "ds:col-[2/-2] ds:min-w-0 ds:text-start";
+/** A section header row: eyebrow at the avatar edge, action at the selects' end edge. */
+export declare const PERSON_HEADER = "ds:col-[1/-2] ds:row-start-1 ds:flex ds:flex-wrap ds:items-center ds:justify-between ds:gap-[var(--spacing-sm)]";
+/** Space between two person blocks: larger than the gap inside one. */
+export declare const PERSON_LIST = "ds:flex ds:flex-col ds:gap-[var(--spacing-md)]";
+/** Put on each section that holds person grids: the container above. */
+export declare const PERSON_SECTION = "ds:@container/person";
+/**
+ * Sizes the channel column to the longest channel label, in every row and
+ * whatever is selected, so all channel selects share one width. A hidden,
+ * zero-height copy of the select trigger per label; the column's
+ * `max-content` width comes from the widest.
+ */
+export declare function ChannelColumnSizer({ meta }: {
+    meta: ChannelMeta;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=person-grid.d.ts.map

package/dist/patterns/signature-request/required-documents.d.ts

@@ -0,0 +1,127 @@
+import { type SelectOption } from '../../components/select';
+import { type OperatorChannel, type SignatureChannel } from './channel-meta';
+/** Select value for "Assign later" in every operator picker. */
+export declare const ASSIGN_LATER = "__assign-later__";
+/** What a required item is. Anamnesis interviews never carry a second signee. */
+export type RequiredSignatureItemKind = 'document' | 'anamnesis';
+/** One outstanding document or anamnesis interview in the batch. */
+export interface RequiredSignatureItem {
+    /** Host id, the key of `operatorAssignments` in the submission. */
+    id: string;
+    kind: RequiredSignatureItemKind;
+    /** Display name, e.g. the document template name. */
+    name: string;
+    /** Whether an operator must sign this item. Shows its operator picker. */
+    requiresOperator: boolean;
+    /**
+     * Whether this document has a field for the second signee. The second
+     * signee is offered only when every listed item can carry it. Ignored for
+     * `kind: 'anamnesis'`, which never can. Default `false`.
+     */
+    canCarrySecondary?: boolean;
+    /**
+     * Preselected operator for this item; `null` preselects "Assign later".
+     * Omit to use the modal's `initialOperatorId`.
+     */
+    initialOperatorId?: string | null;
+    /**
+     * Whether the item is already signed (platform `signed` on a document,
+     * `isSigned` on an interview). Signed items are left out. Default `false`.
+     * There is no per-party standing: platform's documents API has none.
+     */
+    signed?: boolean;
+}
+/** The items that still need a signature: those not signed. */
+export declare function itemsStillToSign(items: readonly RequiredSignatureItem[]): RequiredSignatureItem[];
+/**
+ * The second signee signs the whole batch in one round, so it is offered
+ * only when every item can carry that signature. `[].every()` is true, so an
+ * empty batch cannot.
+ */
+export declare function batchCanCarrySecondary(items: readonly RequiredSignatureItem[]): boolean;
+/** Whether an item gets an operator picker: an operator must sign it. */
+export declare function needsOperatorPick(item: RequiredSignatureItem): boolean;
+/**
+ * One option in an operator picker. "Assign later" comes first, as on
+ * platform (OperatorSignee.js). A `disabled` operator shows greyed out with
+ * its `description` (the host's reason); a `deleted` one is hidden unless it
+ * is the picker's current value.
+ */
+export interface OperatorPickerOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+    description?: string;
+    deleted?: boolean;
+}
+/** The options one picker lists, given its current value. */
+export declare function operatorPickerOptions(options: readonly OperatorPickerOption[], selected: string | undefined): SelectOption[];
+/** Whether a user could pick this value: listed, not greyed out or deleted. */
+export declare function isPickableOperator(options: readonly OperatorPickerOption[], value: string): boolean;
+/**
+ * The greyed-out operators and their reasons, for the picker trigger: a
+ * disabled option cannot take focus, so its own description is never heard.
+ * `undefined` when none is greyed out.
+ */
+export declare function operatorReasonsHint(options: readonly OperatorPickerOption[], locale: string): string | undefined;
+/**
+ * Why the second signee is withheld from a batch, first reason first; `null`
+ * when it is offered. Mirrors platform (secondarySigneeAvailability.ts and
+ * SecondarySignee.tsx): every item can carry it, the batch is signed on this
+ * device, and the main signer is a registered signee, not the patient.
+ */
+export type SecondSigneeBlock = 'anamnesis' | 'documents' | 'patient' | 'channel';
+export declare function secondSigneeBlock({ items, channel, primaryIsPatient, }: {
+    items: readonly RequiredSignatureItem[];
+    channel: SignatureChannel;
+    primaryIsPatient: boolean;
+}): SecondSigneeBlock | null;
+/** What is wrong with the chosen second signee (platform secondarySigneeValidation.ts). */
+export type SecondSigneeIssue = 'sameAsPrimary' | 'unknownSignee' | 'missingPhone' | 'missingEmail';
+/** The parts of a `SignerOption` the second signee checks read. */
+export interface SecondSigneeCandidate {
+    value: string;
+    isPatient?: boolean;
+    availableChannels?: readonly SignatureChannel[];
+    unavailableChannels?: ReadonlyArray<{
+        channel: SignatureChannel;
+    }>;
+}
+/**
+ * The first issue with a second signee, or `null`. Phone and e-mail are read
+ * from channel availability, so no contact data reaches the kit: a person who
+ * cannot receive SMS or WhatsApp has no phone, one who cannot receive e-mail
+ * has no e-mail. The patient is never a signee, so picking them is unknown.
+ */
+export declare function secondSigneeIssue({ primaryId, secondId, channel, options, }: {
+    primaryId: string | undefined;
+    secondId: string;
+    channel: SignatureChannel;
+    options: readonly SecondSigneeCandidate[];
+}): SecondSigneeIssue | null;
+export interface RequiredDocumentsProps {
+    /** The items to list, already narrowed to those still to sign. */
+    items: readonly RequiredSignatureItem[];
+    loading?: boolean;
+    /**
+     * Operator options, "Assign later" first when allowed. Deleted operators
+     * show only in a picker whose value they are.
+     */
+    operatorOptions: readonly OperatorPickerOption[];
+    /** The picker value per item id, for items that require an operator. */
+    assignments: Readonly<Record<string, string>>;
+    onAssign: (itemId: string, operatorValue: string) => void;
+    /** Shows "Assign all to me" when passed. */
+    onAssignAllToMe?: () => void;
+    busy?: boolean;
+    /**
+     * Adds each picked operator's channel beside their picker, in place of
+     * the note that their settings decide. Default `false`.
+     */
+    showOperatorChannels?: boolean;
+    /** The channel per item id, for items with an assigned operator. */
+    operatorChannels?: Readonly<Record<string, OperatorChannel>>;
+    onOperatorChannel?: (itemId: string, channel: OperatorChannel) => void;
+}
+export declare function RequiredDocuments({ items, loading, operatorOptions, assignments, onAssign, onAssignAllToMe, busy, showOperatorChannels, operatorChannels, onOperatorChannel, }: RequiredDocumentsProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=required-documents.d.ts.map

package/dist/patterns/signature-request/signature-history.d.ts

@@ -0,0 +1,57 @@
+import { type SignatureParty, type SignatureSignerNames } from '../../components/signature-status-chip';
+import { type SignatureChannel } from './channel-meta';
+/** Legal weight of a signature. Advanced needs an OTP-verified signer. */
+export type SignatureLegalLevel = 'simple' | 'advanced';
+/** Which file a download asks for. */
+export type SignatureDownloadVersion = 'full' | 'anonymised';
+/** How a signed document is shared. */
+export type SignatureShareTarget = 'link' | 'email' | 'whatsapp';
+/** One past signature request on the document. */
+export interface SignatureRecord {
+    /** Host id, handed back to every row callback. */
+    id: string;
+    /**
+     * When the request was made: a `Date` or an ISO 8601 string, shown as
+     * weekday, date and time in the active locale and the browser's time zone
+     * (Italian: "Mar. il 25/08/2026 ore 12:45"). An unparseable string is
+     * shown as it is.
+     */
+    createdAt: Date | string;
+    /** How the request reached the signer. */
+    channel: SignatureChannel;
+    /** Omit to show no legal level on this row. */
+    legalLevel?: SignatureLegalLevel;
+    /** The operator's standing, as on SignatureStatusChip. */
+    operator: SignatureParty;
+    /** The patient's standing, as on SignatureStatusChip. */
+    patient: SignatureParty;
+    /** The second signee's standing. Defaults to `notRequired`. */
+    secondary?: SignatureParty;
+    /**
+     * Signer names for the chip's tooltip, including who signed on a
+     * party's behalf (a parent for a minor). Same shape as the chip's `names`.
+     */
+    names?: SignatureSignerNames;
+    /** Offer the anonymised file beside the full one on download. */
+    hasAnonymisedVersion?: boolean;
+    /**
+     * Where this document can be shared, e.g. no `'whatsapp'` for a patient
+     * with no mobile number. Wins over the list's `shareTargets`. The menu
+     * keeps its own order (link, e-mail, WhatsApp); an empty list hides Share
+     * on this row.
+     */
+    shareTargets?: readonly SignatureShareTarget[];
+}
+export interface SignatureHistoryProps {
+    signatures?: readonly SignatureRecord[];
+    loading?: boolean;
+    showLegalLevel?: boolean;
+    onView?: (id: string) => void;
+    onDownload?: (id: string, version: SignatureDownloadVersion) => void;
+    onShare?: (id: string, via: SignatureShareTarget) => void;
+    /** Share targets for rows without their own. Default: all three. */
+    shareTargets?: readonly SignatureShareTarget[];
+    onDelete?: (id: string) => void;
+}
+export declare function SignatureHistory({ signatures, loading, showLegalLevel, onView, onDownload, onShare, shareTargets, onDelete, }: SignatureHistoryProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=signature-history.d.ts.map

package/dist/patterns/signature-request/signature-outcome.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Outcome states of SignatureRequestModal: a final screen in the same dialog
+ * once there is nothing left to fill in. The modal puts the title and the
+ * description in its header and its own actions in the footer; this file
+ * holds the copy and the decorative body.
+ */
+import type { TFunction } from 'i18next';
+/**
+ * - `linkSent`: the request went out by link (SMS, e-mail, WhatsApp).
+ * - `allSigned`: nothing is left to sign.
+ * - `creditsExhausted`: the practice has no electronic signature documents
+ *   left, so the request cannot be sent.
+ */
+export type SignatureRequestOutcome = 'linkSent' | 'allSigned' | 'creditsExhausted';
+/**
+ * Title and description for an outcome, in the active locale. `required`
+ * (required documents mode) uses platform's batch copy for `linkSent`.
+ */
+export declare function outcomeCopy(outcome: SignatureRequestOutcome, t: TFunction, { required }?: {
+    required?: boolean;
+}): {
+    title: string;
+    description: string;
+};
+/** The outcome's body: a decorative status icon. The header carries the words. */
+export declare function SignatureOutcome({ outcome, }: {
+    outcome: SignatureRequestOutcome;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=signature-outcome.d.ts.map