@mindbill/react 0.38.0 → 0.40.0

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 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, BrowserBillSubmissionResult, BillLifecycleSessionProvider, BillReviewPayer as BillReviewPayer$1, BrowserBillSubmissionDocument, BillDeliveryOptions as BillDeliveryOptions$1, SubmitBillInput, BillTasksDashboardData, BillTasksAgingBucket, BillHistoryEntry, ReportBillStatusInput, OrganizationProfileData, BillRemittanceSummary, BillEorDocument, BillPaymentRecord, BillLifecycleAction, BillRejection, BillLifecycleData, BillLifecycleClientOptions, BillLifecycleClient } from '@mindbill/browser';
-export { BILL_TASKS_AGING_BUCKETS, BillActivityRecord, BillClaimsAdministratorContact, BillClaimsAdministratorDirectory, BillClaimsAdministratorMailingAddress, BillClaimsAdministratorPattern, BillEorDocument, BillLifecycleAction, BillLifecycleActionId, BillLifecycleClient, BillLifecycleClientOptions, BillLifecycleData, BillLifecycleDelivery, BillLifecycleSession, BillLifecycleSessionProvider, BillLifecycleSessionRequest, BillPaymentRecord, BillRejection, BillRemittanceSummary, 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';
+import { BillReviewData as BillReviewData$1, BillLifecycleDelivery, BillReviewAttachment as BillReviewAttachment$1, BillReviewPayerOption, BrowserBillSubmissionResult, BillLifecycleSessionProvider, BillReviewPayer as BillReviewPayer$1, BrowserBillSubmissionDocument, BillDeliveryOptions as BillDeliveryOptions$1, SubmitBillInput, BillTasksDashboardData, BillTasksAgingBucket, BillHistoryEntry, ReportBillStatusInput, OrganizationProfileData, BillRemittanceSummary, BillEorDocument, BillPaymentRecord, BillLifecycleAction, BillRejection, BillLifecycleData, BillLifecycleClientOptions, BillLifecycleClient } from '@mindbill/browser';
+export { BILL_TASKS_AGING_BUCKETS, BillActivityRecord, BillClaimsAdministratorContact, BillClaimsAdministratorDirectory, BillClaimsAdministratorMailingAddress, BillClaimsAdministratorPattern, BillEorDocument, BillLifecycleAction, BillLifecycleActionId, BillLifecycleClient, BillLifecycleClientOptions, BillLifecycleData, BillLifecycleDelivery, BillLifecycleSession, BillLifecycleSessionProvider, BillLifecycleSessionRequest, BillPaymentRecord, BillRejection, BillRemittanceSummary, BillReviewPayerOption, 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";
 type MindBillReactAppearance = MindBillAppearance & {
@@ -179,6 +179,14 @@ type BillReviewPayer = {
         state: "match" | "warning";
         label: string;
     }>;
+    /** True when a bill for this claims administrator must name one of `payers`. */
+    payerSelectionRequired?: boolean;
+    /** Selectable payers (subpayors) under this claims administrator. */
+    payers?: Array<{
+        id: string;
+        label: string;
+        default?: boolean;
+    }>;
 };
 type BillReviewFeatures = {
     authorizationNumber?: boolean;
@@ -234,6 +242,8 @@ type BillReviewData = {
 };
 type BillReviewSaveInput = {
     claimsAdminId: string;
+    /** The chosen payer (subpayor) when the claims administrator requires payer selection. */
+    payerId?: string;
     patientOverrides?: {
         firstName: string;
         middleName?: string;
@@ -439,6 +449,11 @@ type BillSubmissionInput = {
         claimsAdministrator?: {
             id?: string;
             name: string;
+            /** The chosen payer (subpayor) when the claims administrator requires payer selection. */
+            payerId?: string;
+            /** Directory metadata carried while editing; stripped from the submitted bill. */
+            payerSelectionRequired?: boolean;
+            payers?: BillReviewPayerOption[];
         };
     };
     service: {
@@ -488,6 +503,7 @@ type CompleteBillSubmissionInput = Omit<BillSubmissionInput, "claim" | "billingP
         claimsAdministrator: {
             id: string;
             name: string;
+            payerId?: string;
         };
     };
     billingProvider: {
@@ -609,6 +625,23 @@ declare function validateBillSubmission(bill: BillSubmissionInput): BillSubmissi
 declare function normalizeClaimsAdministratorName(value: string): string;
 declare function exactClaimsAdministratorMatch(results: BillReviewPayer$1[], suppliedName: string): BillReviewPayer$1 | undefined;
 declare function claimsAdministratorRecommendations(results: BillReviewPayer$1[], limit?: number): BillReviewPayer$1[];
+/**
+ * Form-state claims administrator for a directory pick. When the administrator
+ * requires payer selection it carries the payer (subpayor) choices and
+ * preselects the directory default; administrators without subpayors stay a
+ * plain `{ id, name }` reference.
+ */
+declare function chooseClaimsAdministrator(payer: Pick<BillReviewPayer$1, "id" | "name" | "payerSelectionRequired" | "payers">): NonNullable<BillSubmissionInput["claim"]["claimsAdministrator"]>;
+/**
+ * The claims administrator reference exactly as submitted to MindBill: picker
+ * metadata (payerSelectionRequired, payers) stays client-side and the chosen
+ * payerId rides on the wire only when set.
+ */
+declare function submittedClaimsAdministrator(administrator: NonNullable<BillSubmissionInput["claim"]["claimsAdministrator"]>): {
+    id: string;
+    name: string;
+    payerId?: string;
+};
 type BillSubmissionSectionId = "header" | "patient" | "claim" | "providers" | "serviceLines" | "attachments" | "actions";
 declare function BillSubmissionHeader(): ReactElement;
 declare function BillSubmissionPatientSection(): ReactElement;
@@ -987,6 +1020,18 @@ declare function BillHistoryTable({ entries, emptyLabel, appearance, className,
 type BillLifecycleStage = "submitted" | "accepted" | "processed" | "closed";
 /** Maps MindBill's detailed lifecycle state into a compact progress stage. */
 declare function billLifecycleStage(state: string): BillLifecycleStage;
+type BillLifecycleProgressStepsOptions = {
+    /**
+     * Render pre-submission bills ("draft") as a dedicated leading Draft stage
+     * ahead of the Sent→Closed rail. Off by default: hosts whose bills are always
+     * already submitted (the typical partner embed) never see a Draft stage, and
+     * without the flag a draft state keeps the legacy rendering (Sent as the
+     * current stage). Post-submission states render identically either way.
+     */
+    draftStage?: boolean;
+};
+/** True when the lifecycle state is a pre-submission draft. */
+declare function isBillLifecycleDraft(state: string): boolean;
 /** Returns the end-user label for a canonical lifecycle state. */
 declare function billLifecycleDisplayLabel(state: string, nativeStatus?: string): string;
 type BillLifecycleProgressProps = SurfaceProps & {
@@ -994,8 +1039,10 @@ type BillLifecycleProgressProps = SurfaceProps & {
     nativeStatus?: string;
     submittedAt?: string | null;
     agingDays?: number | null;
+    /** Opt-in leading Draft stage for pre-submission bills. See {@link BillLifecycleProgressStepsOptions}. */
+    draftStage?: boolean;
 };
-declare function BillLifecycleProgress({ state, nativeStatus, submittedAt, agingDays, appearance, className, style }: BillLifecycleProgressProps): ReactElement;
+declare function BillLifecycleProgress({ state, nativeStatus, submittedAt, agingDays, draftStage, appearance, className, style }: BillLifecycleProgressProps): ReactElement;
 type BillRejectionNoticeProps = SurfaceProps & {
     rejection: BillRejection;
     title?: string;
@@ -1088,4 +1135,4 @@ type MindBillWidgetProps = {
 declare function MindBillBillTimeline(props: MindBillWidgetProps): ReactElement;
 declare function MindBillBillReview(props: MindBillWidgetProps): ReactElement;
 
-export { BILL_STATUS_AGING_BUCKETS, BILL_SUBMISSION_DIAGNOSIS_QUICK_PICKS, BILL_SUBMISSION_DOCUMENT_TYPES, BILL_SUBMISSION_REPORT_TYPES, BILL_SUBMISSION_REQUIRED_FIELDS, type BillActivityEvent, BillActivityTimeline, type BillActivityTimelineProps, type BillAgingBucket, type BillAgingBucketId, BillAgingSummary, type BillAgingSummaryProps, BillExplanationOfReview, type BillExplanationOfReviewProps, BillHistoryTable, type BillHistoryTableProps, BillLifecycleActions, type BillLifecycleActionsProps, BillLifecycleProgress, type BillLifecycleProgressProps, type BillLifecycleStage, BillList, type BillListProps, BillPayerContactCard, type BillPayerContactCardProps, BillPaymentLedger, type BillPaymentLedgerProps, BillReadOnlyForm, type BillReadOnlyFormProps, BillRejectionNotice, type BillRejectionNoticeProps, BillRemittanceCard, type BillRemittanceCardProps, type BillReviewAttachment, type BillReviewBillingProvider, type BillReviewClinician, type BillReviewData, type BillReviewDocumentType, type BillReviewDraft, type BillReviewFeatures, BillReviewForm, type BillReviewFormProps, type BillReviewLineItem, type BillReviewLocation, type BillReviewPayer, type BillReviewSaveInput, BillSnapshotSummary, type BillSnapshotSummaryProps, type BillStatusAction, type BillStatusAgingCell, BillStatusAgingMatrix, type BillStatusAgingMatrixData, type BillStatusAgingMatrixProps, type BillStatusAgingRow, type BillStatusClient, type BillStatusClientOptions, type BillStatusData, type BillStatusSession, type BillStatusSessionProvider, type BillStatusSessionRequest, BillStatusSummary, type BillStatusSummaryProps, BillSubmissionActions, type BillSubmissionAddress, type BillSubmissionAttachmentReportTypeMode, BillSubmissionAttachmentsSection, BillSubmissionClaimSection, type BillSubmissionDiagnosisOption, type BillSubmissionDocumentType, type BillSubmissionEvaluationType, BillSubmissionForm, type BillSubmissionFormProps, type BillSubmissionFormValue, BillSubmissionHeader, type BillSubmissionInput, type BillSubmissionModifierOption, BillSubmissionPatientSection, type BillSubmissionPostalPlace, type BillSubmissionProcedureOption, BillSubmissionProvidersSection, type BillSubmissionReportTypeOption, type BillSubmissionRibbonItem, type BillSubmissionRoute, type BillSubmissionSectionId, BillSubmissionServiceLinesSection, type BillSubmissionSourceAttachment, type BillSubmissionTaxonomyOption, type BillSubmissionUpload, type BillSubmissionValidation, BillSubmissionsRibbon, type BillSubmissionsRibbonProps, BillTasksDashboard, type BillTasksDashboardCell, type BillTasksDashboardProps, type BillingComponentProps, BillingDashboard, type BillingDashboardBill, type BillingDashboardProps, type BillingDashboardSummary, BillingReport, type BillingReportDimension, type BillingReportProps, type BillingReportRow, BillingSettings, ConnectedBillLifecycle, type ConnectedBillLifecycleProps, ConnectedBillStatus, type ConnectedBillStatusProps, DEFAULT_BILL_SUBMISSION_MODIFIERS, DEFAULT_BILL_SUBMISSION_PROCEDURES, DEFAULT_BILL_SUBMISSION_TAXONOMIES, MED_LEGAL_REPORT_TYPE_CODE, MindBillBillReview, MindBillBillTimeline, type MindBillReactAppearance, type MindBillThemePreset, type MindBillWidgetProps, OrganizationOnboarding, type OrganizationOnboardingProps, PSYCH_QME_DEFAULT_DIAGNOSIS, ReportBillStatusDialog, type ReportBillStatusDialogProps, SendRouteDialog, type SendRouteDialogProps, type SendRouteSubmission, type UseBillLifecycleOptions, type UseBillLifecycleResult, type UseBillStatusOptions, type UseBillStatusResult, applyBillSubmissionEvaluationDiagnoses, applyBillSubmissionEvaluationModifiers, billActivityEventLabel, billAgingBucket, billAgingDays, billLifecycleDisplayLabel, billLifecycleStage, billSubmissionsRibbonDeliveryLabel, billSubmissionsRibbonFromHistory, buildBillReviewSaveInput, buildBillStatusAgingCsv, buildBillStatusAgingMatrix, buildBillingReportCsv, buildBillingReportRows, calculateBillSubmissionAllowedAmount, claimsAdministratorRecommendations, createBillStatusClient, ensureTrailingBillSubmissionLine, ensureTrailingProcedureLine, exactClaimsAdministratorMatch, extractSendRouteEmail, formatBillSubmissionDate, formatSendRouteFax, mindBillAppearanceStyle, mindBillThemePresets, normalizeClaimsAdministratorName, parseBillSubmissionDate, prepareBillSubmissionDocuments, resolveMindBillAppearance, summarizeBillingDashboard, useBillLifecycle, useBillStatus, validateBillSubmission, visibleBillLifecycleActions };
+export { BILL_STATUS_AGING_BUCKETS, BILL_SUBMISSION_DIAGNOSIS_QUICK_PICKS, BILL_SUBMISSION_DOCUMENT_TYPES, BILL_SUBMISSION_REPORT_TYPES, BILL_SUBMISSION_REQUIRED_FIELDS, type BillActivityEvent, BillActivityTimeline, type BillActivityTimelineProps, type BillAgingBucket, type BillAgingBucketId, BillAgingSummary, type BillAgingSummaryProps, BillExplanationOfReview, type BillExplanationOfReviewProps, BillHistoryTable, type BillHistoryTableProps, BillLifecycleActions, type BillLifecycleActionsProps, BillLifecycleProgress, type BillLifecycleProgressProps, type BillLifecycleProgressStepsOptions, type BillLifecycleStage, BillList, type BillListProps, BillPayerContactCard, type BillPayerContactCardProps, BillPaymentLedger, type BillPaymentLedgerProps, BillReadOnlyForm, type BillReadOnlyFormProps, BillRejectionNotice, type BillRejectionNoticeProps, BillRemittanceCard, type BillRemittanceCardProps, type BillReviewAttachment, type BillReviewBillingProvider, type BillReviewClinician, type BillReviewData, type BillReviewDocumentType, type BillReviewDraft, type BillReviewFeatures, BillReviewForm, type BillReviewFormProps, type BillReviewLineItem, type BillReviewLocation, type BillReviewPayer, type BillReviewSaveInput, BillSnapshotSummary, type BillSnapshotSummaryProps, type BillStatusAction, type BillStatusAgingCell, BillStatusAgingMatrix, type BillStatusAgingMatrixData, type BillStatusAgingMatrixProps, type BillStatusAgingRow, type BillStatusClient, type BillStatusClientOptions, type BillStatusData, type BillStatusSession, type BillStatusSessionProvider, type BillStatusSessionRequest, BillStatusSummary, type BillStatusSummaryProps, BillSubmissionActions, type BillSubmissionAddress, type BillSubmissionAttachmentReportTypeMode, BillSubmissionAttachmentsSection, BillSubmissionClaimSection, type BillSubmissionDiagnosisOption, type BillSubmissionDocumentType, type BillSubmissionEvaluationType, BillSubmissionForm, type BillSubmissionFormProps, type BillSubmissionFormValue, BillSubmissionHeader, type BillSubmissionInput, type BillSubmissionModifierOption, BillSubmissionPatientSection, type BillSubmissionPostalPlace, type BillSubmissionProcedureOption, BillSubmissionProvidersSection, type BillSubmissionReportTypeOption, type BillSubmissionRibbonItem, type BillSubmissionRoute, type BillSubmissionSectionId, BillSubmissionServiceLinesSection, type BillSubmissionSourceAttachment, type BillSubmissionTaxonomyOption, type BillSubmissionUpload, type BillSubmissionValidation, BillSubmissionsRibbon, type BillSubmissionsRibbonProps, BillTasksDashboard, type BillTasksDashboardCell, type BillTasksDashboardProps, type BillingComponentProps, BillingDashboard, type BillingDashboardBill, type BillingDashboardProps, type BillingDashboardSummary, BillingReport, type BillingReportDimension, type BillingReportProps, type BillingReportRow, BillingSettings, ConnectedBillLifecycle, type ConnectedBillLifecycleProps, ConnectedBillStatus, type ConnectedBillStatusProps, DEFAULT_BILL_SUBMISSION_MODIFIERS, DEFAULT_BILL_SUBMISSION_PROCEDURES, DEFAULT_BILL_SUBMISSION_TAXONOMIES, MED_LEGAL_REPORT_TYPE_CODE, MindBillBillReview, MindBillBillTimeline, type MindBillReactAppearance, type MindBillThemePreset, type MindBillWidgetProps, OrganizationOnboarding, type OrganizationOnboardingProps, PSYCH_QME_DEFAULT_DIAGNOSIS, ReportBillStatusDialog, type ReportBillStatusDialogProps, SendRouteDialog, type SendRouteDialogProps, type SendRouteSubmission, type UseBillLifecycleOptions, type UseBillLifecycleResult, type UseBillStatusOptions, type UseBillStatusResult, applyBillSubmissionEvaluationDiagnoses, applyBillSubmissionEvaluationModifiers, billActivityEventLabel, billAgingBucket, billAgingDays, billLifecycleDisplayLabel, billLifecycleStage, billSubmissionsRibbonDeliveryLabel, billSubmissionsRibbonFromHistory, buildBillReviewSaveInput, buildBillStatusAgingCsv, buildBillStatusAgingMatrix, buildBillingReportCsv, buildBillingReportRows, calculateBillSubmissionAllowedAmount, chooseClaimsAdministrator, claimsAdministratorRecommendations, createBillStatusClient, ensureTrailingBillSubmissionLine, ensureTrailingProcedureLine, exactClaimsAdministratorMatch, extractSendRouteEmail, formatBillSubmissionDate, formatSendRouteFax, isBillLifecycleDraft, mindBillAppearanceStyle, mindBillThemePresets, normalizeClaimsAdministratorName, parseBillSubmissionDate, prepareBillSubmissionDocuments, resolveMindBillAppearance, submittedClaimsAdministrator, summarizeBillingDashboard, useBillLifecycle, useBillStatus, validateBillSubmission, visibleBillLifecycleActions };

package/dist/index.js

@@ -1296,7 +1296,8 @@ var READ_ONLY_STYLES = `
 import { createContext, useCallback, useContext, useEffect as useEffect4, useMemo as useMemo3, useRef as useRef2, useState as useState4 } from "react";
 import {
   createBillReferenceClient,
-  createBillSubmissionClient
+  createBillSubmissionClient,
+  defaultBillReviewPayerOption
 } from "@mindbill/browser";
 
 // src/send-route-dialog.tsx
@@ -2153,6 +2154,9 @@ function validateBillSubmission(bill) {
   if (bill.claim.claimsAdministrator?.name && !bill.claim.claimsAdministrator.id) {
     errors["claim.claimsAdministrator"] = "Select a claims administrator from the payer directory.";
   }
+  if (bill.claim.claimsAdministrator?.payerSelectionRequired && !bill.claim.claimsAdministrator.payerId?.trim()) {
+    errors["claim.claimsAdministrator.payerId"] = "Select the payer for this claims administrator.";
+  }
   if (bill.patient.dateOfBirth && !parseBillSubmissionDate(bill.patient.dateOfBirth)) errors["patient.dateOfBirth"] = "Use MM/DD/YYYY";
   if (bill.claim.dateOfInjury && !parseBillSubmissionDate(bill.claim.dateOfInjury)) errors["claim.dateOfInjury"] = "Use MM/DD/YYYY";
   if (bill.patient.address.state.trim().length !== 2) errors["patient.address.state"] = "Use a 2-letter state code";
@@ -2298,6 +2302,25 @@ function exactClaimsAdministratorMatch(results, suppliedName) {
 function claimsAdministratorRecommendations(results, limit = 5) {
   return [...results].sort((left, right) => Number(Boolean(right.recommended)) - Number(Boolean(left.recommended))).slice(0, Math.max(0, limit));
 }
+function chooseClaimsAdministrator(payer) {
+  if (!payer.payerSelectionRequired) return { id: payer.id, name: payer.name };
+  const payers = (payer.payers ?? []).map((option) => ({ ...option }));
+  const preselected = defaultBillReviewPayerOption(payer);
+  return {
+    id: payer.id,
+    name: payer.name,
+    payerSelectionRequired: true,
+    ...payers.length ? { payers } : {},
+    ...preselected ? { payerId: preselected.id } : {}
+  };
+}
+function submittedClaimsAdministrator(administrator) {
+  return {
+    id: administrator.id ?? "",
+    name: administrator.name,
+    ...administrator.payerId ? { payerId: administrator.payerId } : {}
+  };
+}
 var BillSubmissionSectionsContext = createContext(null);
 function BillSubmissionSection({ id }) {
   const sections = useContext(BillSubmissionSectionsContext);
@@ -2497,7 +2520,7 @@ function BillSubmissionForm({
       if (request !== payerRequest.current) return;
       setPayerResults(results);
       const exact = autoSelect ? exactClaimsAdministratorMatch(results, trimmed) : void 0;
-      if (exact) setBill((current) => ({ ...current, claim: { ...current.claim, claimsAdministrator: { id: exact.id, name: exact.name } } }));
+      if (exact) setBill((current) => ({ ...current, claim: { ...current.claim, claimsAdministrator: chooseClaimsAdministrator(exact) } }));
     } catch (caught) {
       if (request === payerRequest.current) setFormError(caught instanceof Error ? caught.message : "Claims administrator search is unavailable.");
     } finally {
@@ -2592,7 +2615,14 @@ function BillSubmissionForm({
       return;
     }
     if (selectedIds.length + uploads.length > MAX_DOCUMENTS) return setFormError(`A bill can include at most ${MAX_DOCUMENTS} attachments.`);
-    const complete = clean;
+    const administrator2 = clean.claim.claimsAdministrator;
+    const complete = {
+      ...clean,
+      claim: {
+        ...clean.claim,
+        ...administrator2 ? { claimsAdministrator: submittedClaimsAdministrator(administrator2) } : {}
+      }
+    };
     if (onSubmit) {
       setSubmitting(true);
       try {
@@ -2652,7 +2682,12 @@ function BillSubmissionForm({
   const claimsAdministratorError = errors["claim.claimsAdministrator"];
   const selectedPayer = payerResults.find((payer) => payer.id === bill.claim.claimsAdministrator?.id);
   const payerRecommendations = bill.claim.claimsAdministrator?.id ? [] : claimsAdministratorRecommendations(payerResults);
-  const choosePayer = (payer) => setBill((current) => ({ ...current, claim: { ...current.claim, claimsAdministrator: { id: payer.id, name: payer.name } } }));
+  const choosePayer = (payer) => setBill((current) => ({ ...current, claim: { ...current.claim, claimsAdministrator: chooseClaimsAdministrator(payer) } }));
+  const administrator = bill.claim.claimsAdministrator;
+  const subpayorOptions = administrator?.payerSelectionRequired ? administrator.payers ?? [] : [];
+  const subpayorError = errors["claim.claimsAdministrator.payerId"];
+  const selectedSubpayor = subpayorOptions.find((option) => option.id === administrator?.payerId);
+  const chooseSubpayor = (payerId) => setBill((current) => current.claim.claimsAdministrator ? { ...current, claim: { ...current.claim, claimsAdministrator: { ...current.claim.claimsAdministrator, payerId } } } : current);
   const headerSection = /* @__PURE__ */ jsxs4("div", { className: "mbsf-head", children: [
     /* @__PURE__ */ jsxs4("div", { children: [
       /* @__PURE__ */ jsx4("h3", { className: "mbsf-title", children: heading }),
@@ -2693,7 +2728,7 @@ function BillSubmissionForm({
       /* @__PURE__ */ jsx4(Field2, { path: "claim.claimNumber", label: "Claim number", required: true, error: errors["claim.claimNumber"], children: text(bill.claim.claimNumber, (claimNumber) => setBill((c) => ({ ...c, claim: { ...c.claim, claimNumber } }))) }),
       /* @__PURE__ */ jsx4(Field2, { label: "WCAB / ADJ number (optional)", children: text(bill.claim.adjNumber, (adjNumber) => setBill((c) => ({ ...c, claim: { ...c.claim, adjNumber } }))) }),
       /* @__PURE__ */ jsxs4(Field2, { path: "claim.claimsAdministrator", label: "Claims administrator", required: true, span: true, error: claimsAdministratorError, children: [
-        /* @__PURE__ */ jsx4(ComboBox, { ariaLabel: "Claims administrator", invalid: Boolean(claimsAdministratorError), disabled: locked, loading: payerLoading, preserveValueOnOpen: true, value: bill.claim.claimsAdministrator?.name ?? "", placeholder: "Search the payer directory\u2026", options: payerResults.map((payer) => ({ id: payer.id, label: payer.name, detail: [payer.hasElectronic ? "Electronic" : "Work comp", ...payer.states ?? []].join(" \xB7 ") })), onQuery: searchPayers, onSelect: (option) => choosePayer({ id: option.id, name: option.label }) }),
+        /* @__PURE__ */ jsx4(ComboBox, { ariaLabel: "Claims administrator", invalid: Boolean(claimsAdministratorError), disabled: locked, loading: payerLoading, preserveValueOnOpen: true, value: bill.claim.claimsAdministrator?.name ?? "", placeholder: "Search the payer directory\u2026", options: payerResults.map((payer) => ({ id: payer.id, label: payer.name, detail: [payer.hasElectronic ? "Electronic" : "Work comp", ...payer.states ?? []].join(" \xB7 ") })), onQuery: searchPayers, onSelect: (option) => choosePayer(payerResults.find((payer) => payer.id === option.id) ?? { id: option.id, name: option.label }) }),
         selectedPayer ? /* @__PURE__ */ jsxs4("div", { className: "mbsf-payer-status", role: "status", children: [
           /* @__PURE__ */ jsx4("strong", { children: "\u2713 Routing match set:" }),
           " ",
@@ -2724,6 +2759,14 @@ function BillSubmissionForm({
         ] }) : null,
         !selectedPayer && !payerLoading && !payerRecommendations.length && (bill.claim.claimsAdministrator?.name.trim().length ?? 0) >= 2 ? /* @__PURE__ */ jsx4("small", { className: "mbsf-help", children: "No confident route selected yet. Search the directory and choose a claims administrator." }) : null
       ] }),
+      administrator?.payerSelectionRequired && subpayorOptions.length ? /* @__PURE__ */ jsxs4(Field2, { path: "claim.claimsAdministrator.payerId", label: "Payer", required: true, span: true, error: subpayorError, children: [
+        /* @__PURE__ */ jsx4(ComboBox, { ariaLabel: "Payer", invalid: Boolean(subpayorError), disabled: locked, preserveValueOnOpen: true, value: selectedSubpayor?.label ?? "", placeholder: "Select the payer for this claims administrator\u2026", options: subpayorOptions.map((option) => ({ id: option.id, label: option.label, ...option.default ? { detail: "Default" } : {} })), onSelect: (option) => chooseSubpayor(option.id) }),
+        selectedSubpayor ? /* @__PURE__ */ jsxs4("div", { className: "mbsf-payer-status", role: "status", children: [
+          /* @__PURE__ */ jsx4("strong", { children: "\u2713 Payer set:" }),
+          " ",
+          selectedSubpayor.label
+        ] }) : /* @__PURE__ */ jsx4("small", { className: "mbsf-help", children: "This claims administrator routes bills per payer. Choose the payer that should receive this bill." })
+      ] }) : null,
       /* @__PURE__ */ jsx4(Field2, { label: "Injury description (optional)", span: true, children: text(bill.claim.description, (description2) => setBill((c) => ({ ...c, claim: { ...c.claim, description: description2 } }))) }),
       /* @__PURE__ */ jsxs4(Field2, { path: "diagnoses", label: "Diagnosis codes (ICD-10)", required: true, span: true, error: errors.diagnoses, children: [
         /* @__PURE__ */ jsx4("div", { className: "mbsf-quick-picks", "aria-label": "Common diagnosis codes", children: BILL_SUBMISSION_DIAGNOSIS_QUICK_PICKS.map((option) => {
@@ -4500,13 +4543,22 @@ function billLifecycleStage(state) {
   if (value.includes("accepted")) return "accepted";
   return "submitted";
 }
-function billLifecycleProgressSteps(state) {
+function isBillLifecycleDraft(state) {
+  return state.toLowerCase() === "draft";
+}
+function billLifecycleProgressSteps(state, options) {
   if (state.toLowerCase() === "rejected") {
     return [
       { id: "submitted", label: "Sent", status: "complete" },
       { id: "rejected", label: "Rejected", status: "current" }
     ];
   }
+  if (options?.draftStage && isBillLifecycleDraft(state)) {
+    return [
+      { id: "draft", label: "Draft", status: "current" },
+      ...lifecycleStages.map((stage) => ({ ...stage, status: "upcoming" }))
+    ];
+  }
   const current = billLifecycleStage(state);
   const currentIndex = lifecycleStages.findIndex((stage) => stage.id === current);
   return lifecycleStages.map((stage, index) => ({
@@ -4524,14 +4576,15 @@ function billLifecycleDisplayLabel(state, nativeStatus) {
   if (value === "written_off") return "Written off";
   return humanize(state || nativeStatus || "submitted");
 }
-function BillLifecycleProgress({ state, nativeStatus, submittedAt, agingDays, appearance, className, style }) {
+function BillLifecycleProgress({ state, nativeStatus, submittedAt, agingDays, draftStage, appearance, className, style }) {
   const rejected = state.toLowerCase() === "rejected";
-  const steps = billLifecycleProgressSteps(state);
+  const draft = Boolean(draftStage) && isBillLifecycleDraft(state);
+  const steps = billLifecycleProgressSteps(state, { draftStage: Boolean(draftStage) });
   return /* @__PURE__ */ jsxs12("section", { className: classes(`mb-surface mb-progress${rejected ? " is-rejected" : ""}`, className), style: mindBillAppearanceStyle(appearance, style), "aria-label": "Bill lifecycle", children: [
     /* @__PURE__ */ jsx12("style", { children: lifecycleSurfaceStyles }),
     /* @__PURE__ */ jsx12("header", { className: "mb-surface-heading", children: /* @__PURE__ */ jsxs12("div", { children: [
       /* @__PURE__ */ jsx12("strong", { children: billLifecycleDisplayLabel(state, nativeStatus) }),
-      /* @__PURE__ */ jsx12("span", { children: rejected ? "The payer rejected this submission." : `${submittedAt ? `Submitted ${defaultFormatDate(submittedAt)}` : "Submitted"}${typeof agingDays === "number" ? ` \xB7 ${agingDays} days old` : ""}` })
+      /* @__PURE__ */ jsx12("span", { children: rejected ? "The payer rejected this submission." : draft ? "Not yet sent" : `${submittedAt ? `Submitted ${defaultFormatDate(submittedAt)}` : "Submitted"}${typeof agingDays === "number" ? ` \xB7 ${agingDays} days old` : ""}` })
     ] }) }),
     /* @__PURE__ */ jsx12("ol", { className: "mb-progress-list", style: { gridTemplateColumns: `repeat(${steps.length}, minmax(0, 1fr))` }, children: steps.map((step, index) => /* @__PURE__ */ jsxs12("li", { className: `is-${step.status}`, "aria-current": step.status === "current" ? "step" : void 0, children: [
       /* @__PURE__ */ jsx12("span", { "aria-hidden": "true", children: step.status === "complete" ? "\u2713" : rejected && step.status === "current" ? "!" : index + 1 }),
@@ -5729,6 +5782,7 @@ export {
   buildBillingReportCsv,
   buildBillingReportRows,
   calculateBillSubmissionAllowedAmount,
+  chooseClaimsAdministrator,
   claimsAdministratorRecommendations,
   createBillLifecycleClient2 as createBillLifecycleClient,
   createBillStatusClient,
@@ -5738,6 +5792,7 @@ export {
   extractSendRouteEmail,
   formatBillSubmissionDate,
   formatSendRouteFax,
+  isBillLifecycleDraft,
   mindBillAppearanceStyle,
   mindBillThemePresets,
   normalizeClaimsAdministratorName,
@@ -5746,6 +5801,7 @@ export {
   reportBillStatusContacts2 as reportBillStatusContacts,
   resolveMindBillAppearance,
   secondReviewDeadline2 as secondReviewDeadline,
+  submittedClaimsAdministrator,
   summarizeBillingDashboard,
   useBillLifecycle,
   useBillStatus,