@mindbill/react 0.42.4 → 0.43.0

package/README.md

@@ -120,8 +120,11 @@ snapshot and authenticated copies of its documents. API-provided rejection
 `fieldPaths` call attention to likely problem controls, and payer contact
 guidance remains visible while the user corrects the bill. Submitting creates
 the next immutable attempt under the same logical `billId`; the original
-attempt and rejection remain in history. The host application does not build a
-second correction form or pass bill seed data back into the lifecycle.
+attempt and rejection remain in history. Submit first opens a required delivery
+confirmation for the corrected administrator and selected subpayor, where the
+biller can verify or switch among e-bill, fax, email, and mail. Nothing is sent
+until that second confirmation is submitted. The host application does not
+build a second correction form or pass bill seed data back into the lifecycle.
 
 For a **closed** bill the server authorizes exactly two actions — **Reopen**
 and **Submit New Bill**. Submit New Bill opens the same `BillSubmissionForm`,
@@ -335,7 +338,13 @@ const data = buildBillTasksDashboard(workItems, [
 />
 ```
 
-`BillSubmissionsRibbon` renders a horizontal row of submission chips (Original Bill, Second Review, Duplicate Bill, …) with an optional deadline badge and up to three label/value meta pairs; `billSubmissionsRibbonFromHistory` maps the presented history's submission rows into chips.
+`BillSubmissionsRibbon` renders a horizontal row of selectable submission chips
+(Original Bill, Second Review, Duplicate Bill, …). Each chip summarizes its
+attempt's latest acknowledgement or payment state — for example `277 Reject`
+or `Payment in 30 working days` — plus delivery, sent date, and the relevant
+reject/effective date. `billSubmissionsRibbonFromHistory` derives those chips
+from one unified history across every attempt. In `ConnectedBillLifecycle`, a
+chip click opens that shared history and highlights the selected submission.
 
 `ReportBillStatusDialog` records the outcome of a payment-status phone call to the Claims Administrator / Bill Review vendor: payer contacts, the host-rendered submission receipt (for example a `BillHistoryTable`), and the five standard reported statuses (`REPORT_BILL_STATUS_OPTIONS`). The host posts the resulting `ReportBillStatusInput` through its own lifecycle action call.
 

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { MindBillAppearance, MindBillEventDetail, MindBillErrorDetail } from '@mindbill/embed';
 export { MindBillAppearance, MindBillErrorDetail, MindBillEventDetail } from '@mindbill/embed';
 import { CSSProperties, ReactElement, ReactNode } from 'react';
-import { BillReviewData as BillReviewData$1, BillLifecycleDelivery, BillReviewAttachment as BillReviewAttachment$1, BillReviewPayerOption, BrowserBillSubmissionResult, BillLifecycleSessionProvider, BillReviewPayerListInput, BillReviewPayerPage, BillReviewPayer as BillReviewPayer$1, BillClaimsAdministratorDirectory, BillClaimsAdministratorSource, BrowserBillSubmissionDocument, BillDeliveryOptions as BillDeliveryOptions$1, SubmitBillInput, BillTasksDashboardData, BillTasksAgingBucket, BillHistoryEntry, ReportBillStatusInput, OrganizationProfileData, BillRemittanceSummary, BillEorDocument, BillPaymentRecord, BillLifecycleAction, BillRejection, BillLifecycleData, BillLifecycleClientOptions, BillLifecycleClient } from '@mindbill/browser';
+import { BillReviewData as BillReviewData$1, BillLifecycleDelivery, BillReviewAttachment as BillReviewAttachment$1, SubmitBillInput, BillDeliveryOptions as BillDeliveryOptions$1, BillReviewPayerOption, BrowserBillSubmissionResult, BillLifecycleSessionProvider, BillReviewPayerListInput, BillReviewPayerPage, BillReviewPayer as BillReviewPayer$1, BillClaimsAdministratorDirectory, BillClaimsAdministratorSource, BrowserBillSubmissionDocument, BillTasksDashboardData, BillTasksAgingBucket, BillHistoryEntry, BillAttemptSummary, ReportBillStatusInput, OrganizationProfileData, BillRemittanceSummary, BillEorDocument, BillPaymentRecord, BillLifecycleAction, BillRejection, BillLifecycleData, BillLifecycleClientOptions, BillLifecycleClient } from '@mindbill/browser';
 export { BILL_TASKS_AGING_BUCKETS, BillActivityRecord, BillClaimsAdministratorContact, BillClaimsAdministratorDirectory, BillClaimsAdministratorMailingAddress, BillClaimsAdministratorPattern, BillClaimsAdministratorPayer, BillClaimsAdministratorSource, BillEorDocument, BillLifecycleAction, BillLifecycleActionId, BillLifecycleClient, BillLifecycleClientOptions, BillLifecycleData, BillLifecycleDelivery, BillLifecycleSession, BillLifecycleSessionProvider, BillLifecycleSessionRequest, BillPaymentRecord, BillRejection, BillRemittanceSummary, BillReviewPayerOption, BillReviewPayerSuggestion, BillTasksAgingBucket, BillTasksDashboardData, BillTasksDashboardItem, BillTasksDashboardRow, BillTasksDashboardSection, BillTasksDashboardSectionInput, BillTasksDashboardTone, BrowserBillSubmissionResult, CloseBillInput, PostBillPaymentInput, REPORT_BILL_STATUS_OPTIONS, ReopenBillInput, ReportBillStatusContacts, ReportBillStatusId, ReportBillStatusInput, SECOND_REVIEW_REASON_TEMPLATE, SECOND_REVIEW_WINDOW_DAYS, SecondReviewDeadline, SendDuplicateBillInput, SubmitSecondReviewInput, billTasksAgingBucketIndex, buildBillTasksDashboard, createBillLifecycleClient, reportBillStatusContacts, secondReviewDeadline } from '@mindbill/browser';
 
 type MindBillThemePreset = "mindbill" | "qme-companion" | "orange-bright" | "clinical-blue" | "midnight-cyan";
@@ -384,6 +384,24 @@ type BillReadOnlyFormProps = {
 };
 declare function BillReadOnlyForm({ data, appearance, className, style, onOpenAttachment }: BillReadOnlyFormProps): ReactElement;
 
+/** First plausible email address inside a raw contact string, or null. */
+declare function extractSendRouteEmail(raw: string | null | undefined): string | null;
+/** "(213) 555-0199" for 10/11-digit US numbers; anything else trimmed as-is. */
+declare function formatSendRouteFax(raw: string | null | undefined): string;
+type SendRouteSubmission = Pick<SubmitBillInput, "route" | "destination" | "attention" | "subject" | "note" | "cc">;
+type SendRouteDialogProps = {
+    /** Dialog heading, e.g. "Send bill". */
+    title?: ReactNode;
+    delivery: BillDeliveryOptions$1;
+    submitting?: boolean;
+    /** Disables the confirm button while the caller uploads documents. */
+    disabled?: boolean;
+    error?: string | null;
+    onCancel: () => void;
+    onConfirm: (submission: SendRouteSubmission) => void;
+};
+declare function SendRouteDialog({ title, delivery, submitting, disabled, error, onCancel, onConfirm, }: SendRouteDialogProps): ReactElement;
+
 declare const BILL_SUBMISSION_DOCUMENT_TYPES: readonly ["final_report", "proof_of_service", "letter_of_attestation", "form_122", "return_to_work_voucher", "w9", "medical_records", "appeal", "other"];
 type BillSubmissionDocumentType = (typeof BILL_SUBMISSION_DOCUMENT_TYPES)[number];
 type BillSubmissionAttachmentReportTypeMode = "auto" | "hidden" | "visible";
@@ -549,6 +567,8 @@ type BillSubmissionUpload = {
 };
 type BillSubmissionFormValue = {
     bill: CompleteBillSubmissionInput;
+    /** Delivery route explicitly confirmed by the biller, when the route picker is enabled. */
+    submission?: SendRouteSubmission;
     sourceAttachmentIds: string[];
     sourceAttachmentReportTypes: Record<string, string>;
     uploads: BillSubmissionUpload[];
@@ -586,10 +606,13 @@ type BillSubmissionFormProps = {
     taxonomyOptions?: BillSubmissionTaxonomyOption[];
     /**
      * The delivery-method dialog shown when the biller submits.
-     * "auto" (default) shows it in connected mode whenever the delivery preview
-     * is available; "off" submits directly on MindBill's recommended route.
+     * "auto" (default) shows it whenever the delivery preview is available;
+     * "required" fails closed until the biller confirms a route; "off" submits
+     * directly on MindBill's recommended route.
      */
-    deliveryRoutePicker?: "auto" | "off";
+    deliveryRoutePicker?: "auto" | "required" | "off";
+    /** Heading for the delivery confirmation dialog. */
+    deliveryRouteDialogTitle?: ReactNode;
     /** Auto hides and forces J4 for med-legal bills; treatment bills show the full report-type directory. */
     attachmentReportTypeMode?: BillSubmissionAttachmentReportTypeMode;
     attachmentReportTypes?: readonly BillSubmissionReportTypeOption[];
@@ -659,25 +682,7 @@ declare function BillSubmissionProvidersSection(): ReactElement;
 declare function BillSubmissionServiceLinesSection(): ReactElement;
 declare function BillSubmissionAttachmentsSection(): ReactElement;
 declare function BillSubmissionActions(): ReactElement;
-declare function BillSubmissionForm({ initialBill, attachments, onSubmit, onSubmitted, getSession, sessionEndpoint, apiBaseUrl, fetch: fetchOverride, onListClaimsAdministrators, onSearchClaimsAdministrators, onGetClaimsAdministratorDirectory, claimsAdministratorSources, claimsAdministratorHint, diagnosisOptions, onSearchDiagnoses, onLookupPostalCode, procedureOptions, modifierOptions, taxonomyOptions, deliveryRoutePicker, attachmentReportTypeMode, attachmentReportTypes, defaultAttachmentReportType, appearance, className, style, disabled, submitLabel, heading, description, attentionFields, attentionMessage, children, }: BillSubmissionFormProps): ReactElement;
-
-/** First plausible email address inside a raw contact string, or null. */
-declare function extractSendRouteEmail(raw: string | null | undefined): string | null;
-/** "(213) 555-0199" for 10/11-digit US numbers; anything else trimmed as-is. */
-declare function formatSendRouteFax(raw: string | null | undefined): string;
-type SendRouteSubmission = Pick<SubmitBillInput, "route" | "destination" | "attention" | "subject" | "note" | "cc">;
-type SendRouteDialogProps = {
-    /** Dialog heading, e.g. "Send bill". */
-    title?: ReactNode;
-    delivery: BillDeliveryOptions$1;
-    submitting?: boolean;
-    /** Disables the confirm button while the caller uploads documents. */
-    disabled?: boolean;
-    error?: string | null;
-    onCancel: () => void;
-    onConfirm: (submission: SendRouteSubmission) => void;
-};
-declare function SendRouteDialog({ title, delivery, submitting, disabled, error, onCancel, onConfirm, }: SendRouteDialogProps): ReactElement;
+declare function BillSubmissionForm({ initialBill, attachments, onSubmit, onSubmitted, getSession, sessionEndpoint, apiBaseUrl, fetch: fetchOverride, onListClaimsAdministrators, onSearchClaimsAdministrators, onGetClaimsAdministratorDirectory, claimsAdministratorSources, claimsAdministratorHint, diagnosisOptions, onSearchDiagnoses, onLookupPostalCode, procedureOptions, modifierOptions, taxonomyOptions, deliveryRoutePicker, deliveryRouteDialogTitle, attachmentReportTypeMode, attachmentReportTypes, defaultAttachmentReportType, appearance, className, style, disabled, submitLabel, heading, description, attentionFields, attentionMessage, children, }: BillSubmissionFormProps): ReactElement;
 
 /** Public-domain and MindBill-owned metadata. CPT descriptions are intentionally limited to the curated catalog. */
 declare const DEFAULT_BILL_SUBMISSION_PROCEDURES: BillSubmissionProcedureOption[];
@@ -846,10 +851,14 @@ type SurfaceProps$2 = {
 };
 type BillSubmissionRibbonItem = {
     id: string;
+    /** Submission history row to reveal when this attempt is selected. */
+    historyEntryId?: string;
     /** "Original Bill" | "Second Review" | "Duplicate Bill" | … */
     label: string;
     /** Small rounded badge, e.g. "Denial in 3 working days". */
     badge?: string;
+    /** Semantic color for the status badge. */
+    badgeTone?: "neutral" | "success" | "warning" | "danger";
     /** Up to three label/value pairs rendered under the label. */
     meta?: Array<{
         label: string;
@@ -864,8 +873,11 @@ type BillSubmissionsRibbonProps = SurfaceProps$2 & {
 };
 /** Maps a presented-history submission summary to its delivery route word. */
 declare function billSubmissionsRibbonDeliveryLabel(summary: string): string;
-/** Builds ribbon items from MindBill's presented history (submission rows only). */
-declare function billSubmissionsRibbonFromHistory(history: BillHistoryEntry[]): BillSubmissionRibbonItem[];
+/**
+ * Builds one item per immutable submission attempt. Each card summarizes the
+ * payer events following that attempt, while the full history remains unified.
+ */
+declare function billSubmissionsRibbonFromHistory(history: BillHistoryEntry[], attempts?: BillAttemptSummary[]): BillSubmissionRibbonItem[];
 declare function BillSubmissionsRibbon({ items, onSelect, appearance, className, style, }: BillSubmissionsRibbonProps): ReactElement;
 
 type SurfaceProps$1 = {
@@ -1010,6 +1022,8 @@ declare function billActivityEventLabel(type: string): string;
 declare function BillActivityTimeline({ events, emptyLabel, appearance, className, style, formatDate }: BillActivityTimelineProps): ReactElement;
 type BillHistoryTableProps = SurfaceProps & {
     entries: readonly BillHistoryEntry[];
+    /** History row selected from the submissions ribbon. */
+    selectedEntryId?: string;
     emptyLabel?: string;
     /** Formats the Date column. Defaults to MM/DD/YYYY. */
     formatDate?: (iso: string) => string;
@@ -1030,7 +1044,7 @@ type BillHistoryTableProps = SurfaceProps & {
  * are pale-yellow, and 277 responses expand into decoded status-code sentences. The
  * rows come pre-worded from the MindBill API (`BillLifecycleData.history`).
  */
-declare function BillHistoryTable({ entries, emptyLabel, appearance, className, style, formatDate, documentHref, onOpenDocument }: BillHistoryTableProps): ReactElement;
+declare function BillHistoryTable({ entries, selectedEntryId, emptyLabel, appearance, className, style, formatDate, documentHref, onOpenDocument }: BillHistoryTableProps): ReactElement;
 type BillLifecycleStage = "submitted" | "accepted" | "processed" | "closed";
 /** Maps MindBill's detailed lifecycle state into a compact progress stage. */
 declare function billLifecycleStage(state: string): BillLifecycleStage;