@mindbill/react 0.21.1 → 0.21.3

package/README.md

@@ -153,7 +153,7 @@ The component includes the interaction model, not just the markup:
 - a responsive two-column review form (one column on narrow screens);
 - paste-friendly `MM/DD/YYYY` date fields and required-field asterisks;
 - ZIP-to-city/state completion through MindBill's authenticated postal directory;
-- complete, server-backed ICD-10 search, common-injury quick picks, and removable chips;
+- complete, server-backed ICD-10 search with an alphabetized 100-code first page, automatic 100-code scroll paging, common-injury quick picks, and removable chips;
 - canonical claims-administrator search through the authenticated MindBill payer directory;
 - QME, AME, and Psych QME evaluation modes with medical-legal modifier defaults;
 - searchable workers-comp procedure/modifier controls, medical-legal fee-schedule amounts, totals, valid manual CPT/HCPCS entry, and an automatically maintained empty line;
@@ -161,6 +161,8 @@ The component includes the interaction model, not just the markup:
 
 Partners supply tenant-specific bootstrap data, one short-lived browser session callback, and the final server submission callback. Required fields, validation, ZIP lookup, ICD-10 and payer directories, service-line behavior, attachments, and submission UX stay inside `@mindbill/react`, so every integration receives the same billing workflow. Optional `diagnosisOptions`, `procedureOptions`, `modifierOptions`, and lookup callbacks extend or replace defaults when a partner has licensed or organization-specific data.
 
+Validation is component-owned as well. A missing routing payer is highlighted immediately; Submit highlights every invalid control with a specific message, focuses and scrolls to the first problem, and continues validating as the user corrects the form.
+
 `BILL_SUBMISSION_REQUIRED_FIELDS` and `validateBillSubmission` expose the same contract for tests and non-visual integrations. The component never creates a draft; its callback fires only when the user submits a locally valid snapshot.
 
 `BillReviewForm` remains available for legacy integrations that already own a custom review model. New integrations should use `BillSubmissionForm`.

package/dist/index.d.ts

@@ -51,20 +51,20 @@ declare const mindBillThemePresets: {
         readonly fontFamily: "Inter, ui-sans-serif, system-ui, sans-serif";
     };
     readonly "orange-bright": {
-        readonly accentColor: "#ff4f0a";
+        readonly accentColor: "#f4510b";
         readonly accentTextColor: "#ffffff";
         readonly backgroundColor: "#fffaf6";
-        readonly surfaceColor: "#ffffff";
+        readonly surfaceColor: "#fffefd";
         readonly inputBackgroundColor: "#ffffff";
-        readonly textColor: "#111827";
+        readonly textColor: "#090f1f";
         readonly mutedColor: "#626a73";
-        readonly borderColor: "#e5e1dc";
-        readonly borderRadius: "8px";
-        readonly controlRadius: "6px";
-        readonly shadow: "0 4px 18px rgba(17,24,39,.06)";
-        readonly dangerColor: "#b42318";
-        readonly successColor: "#16794f";
-        readonly warningColor: "#9a5b13";
+        readonly borderColor: "#e7e1da";
+        readonly borderRadius: "16px";
+        readonly controlRadius: "10px";
+        readonly shadow: "0 12px 36px rgba(244,81,11,.08), 0 1px 2px rgba(9,15,31,.05)";
+        readonly dangerColor: "#c4322b";
+        readonly successColor: "#16835b";
+        readonly warningColor: "#a65f00";
         readonly fontFamily: "Inter, ui-sans-serif, system-ui, sans-serif";
     };
     readonly "clinical-blue": {
@@ -481,7 +481,7 @@ type BillSubmissionFormProps = {
     fetch?: typeof globalThis.fetch;
     onSearchClaimsAdministrators?: (query: string, claimNumber?: string) => Promise<BillReviewPayer$1[]>;
     diagnosisOptions?: BillSubmissionDiagnosisOption[];
-    onSearchDiagnoses?: (query: string) => Promise<BillSubmissionDiagnosisOption[]>;
+    onSearchDiagnoses?: (query: string, limit?: number, offset?: number) => Promise<BillSubmissionDiagnosisOption[]>;
     onLookupPostalCode?: (postalCode: string) => Promise<BillSubmissionPostalPlace | null>;
     procedureOptions?: BillSubmissionProcedureOption[];
     modifierOptions?: BillSubmissionModifierOption[];
@@ -613,6 +613,8 @@ declare function BillActivityTimeline({ events, emptyLabel, appearance, classNam
 type BillLifecycleStage = "submitted" | "accepted" | "processed" | "closed";
 /** Maps MindBill's detailed lifecycle state into a compact progress stage. */
 declare function billLifecycleStage(state: string): BillLifecycleStage;
+/** Returns the end-user label for a canonical lifecycle state. */
+declare function billLifecycleDisplayLabel(state: string, nativeStatus?: string): string;
 type BillLifecycleProgressProps = SurfaceProps & {
     state: string;
     nativeStatus?: string;
@@ -657,6 +659,8 @@ type UseBillLifecycleResult = {
     reopenBill: BillLifecycleClient["reopenBill"];
     postPayment: BillLifecycleClient["postPayment"];
     submitSecondReview: BillLifecycleClient["submitSecondReview"];
+    resubmitBill: BillLifecycleClient["resubmitBill"];
+    simulateSandbox: BillLifecycleClient["simulateSandbox"];
 };
 declare function useBillLifecycle({ billId: providedBillId, sessionEndpoint, getSession, apiBaseUrl, refreshInterval, enabled, initialData, fetch: fetchOverride, }: UseBillLifecycleOptions): UseBillLifecycleResult;
 type ConnectedBillLifecycleProps = UseBillLifecycleOptions & {
@@ -681,4 +685,4 @@ type MindBillWidgetProps = {
 declare function MindBillBillTimeline(props: MindBillWidgetProps): ReactElement;
 declare function MindBillBillReview(props: MindBillWidgetProps): ReactElement;
 
-export { BILL_SUBMISSION_DIAGNOSIS_QUICK_PICKS, BILL_SUBMISSION_DOCUMENT_TYPES, BILL_SUBMISSION_REQUIRED_FIELDS, type BillActivityEvent, BillActivityTimeline, type BillActivityTimelineProps, BillLifecycleActions, type BillLifecycleActionsProps, BillLifecycleProgress, type BillLifecycleProgressProps, type BillLifecycleStage, BillPayerContactCard, type BillPayerContactCardProps, BillPaymentLedger, type BillPaymentLedgerProps, BillReadOnlyForm, type BillReadOnlyFormProps, 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 BillStatusClient, type BillStatusClientOptions, type BillStatusData, type BillStatusSession, type BillStatusSessionProvider, type BillStatusSessionRequest, BillStatusSummary, type BillStatusSummaryProps, type BillSubmissionAddress, type BillSubmissionDiagnosisOption, type BillSubmissionDocumentType, type BillSubmissionEvaluationType, BillSubmissionForm, type BillSubmissionFormProps, type BillSubmissionFormValue, type BillSubmissionInput, type BillSubmissionModifierOption, type BillSubmissionPostalPlace, type BillSubmissionProcedureOption, type BillSubmissionRoute, type BillSubmissionSourceAttachment, type BillSubmissionUpload, type BillSubmissionValidation, ConnectedBillLifecycle, type ConnectedBillLifecycleProps, ConnectedBillStatus, type ConnectedBillStatusProps, DEFAULT_BILL_SUBMISSION_MODIFIERS, DEFAULT_BILL_SUBMISSION_PROCEDURES, MindBillBillReview, MindBillBillTimeline, type MindBillReactAppearance, type MindBillThemePreset, type MindBillWidgetProps, type UseBillLifecycleOptions, type UseBillLifecycleResult, type UseBillStatusOptions, type UseBillStatusResult, applyBillSubmissionEvaluationModifiers, billActivityEventLabel, billLifecycleStage, buildBillReviewSaveInput, calculateBillSubmissionAllowedAmount, createBillStatusClient, ensureTrailingBillSubmissionLine, ensureTrailingProcedureLine, formatBillSubmissionDate, mindBillAppearanceStyle, mindBillThemePresets, parseBillSubmissionDate, resolveMindBillAppearance, useBillLifecycle, useBillStatus, validateBillSubmission, visibleBillLifecycleActions };
+export { BILL_SUBMISSION_DIAGNOSIS_QUICK_PICKS, BILL_SUBMISSION_DOCUMENT_TYPES, BILL_SUBMISSION_REQUIRED_FIELDS, type BillActivityEvent, BillActivityTimeline, type BillActivityTimelineProps, BillLifecycleActions, type BillLifecycleActionsProps, BillLifecycleProgress, type BillLifecycleProgressProps, type BillLifecycleStage, BillPayerContactCard, type BillPayerContactCardProps, BillPaymentLedger, type BillPaymentLedgerProps, BillReadOnlyForm, type BillReadOnlyFormProps, 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 BillStatusClient, type BillStatusClientOptions, type BillStatusData, type BillStatusSession, type BillStatusSessionProvider, type BillStatusSessionRequest, BillStatusSummary, type BillStatusSummaryProps, type BillSubmissionAddress, type BillSubmissionDiagnosisOption, type BillSubmissionDocumentType, type BillSubmissionEvaluationType, BillSubmissionForm, type BillSubmissionFormProps, type BillSubmissionFormValue, type BillSubmissionInput, type BillSubmissionModifierOption, type BillSubmissionPostalPlace, type BillSubmissionProcedureOption, type BillSubmissionRoute, type BillSubmissionSourceAttachment, type BillSubmissionUpload, type BillSubmissionValidation, ConnectedBillLifecycle, type ConnectedBillLifecycleProps, ConnectedBillStatus, type ConnectedBillStatusProps, DEFAULT_BILL_SUBMISSION_MODIFIERS, DEFAULT_BILL_SUBMISSION_PROCEDURES, MindBillBillReview, MindBillBillTimeline, type MindBillReactAppearance, type MindBillThemePreset, type MindBillWidgetProps, type UseBillLifecycleOptions, type UseBillLifecycleResult, type UseBillStatusOptions, type UseBillStatusResult, applyBillSubmissionEvaluationModifiers, billActivityEventLabel, billLifecycleDisplayLabel, billLifecycleStage, buildBillReviewSaveInput, calculateBillSubmissionAllowedAmount, createBillStatusClient, ensureTrailingBillSubmissionLine, ensureTrailingProcedureLine, formatBillSubmissionDate, mindBillAppearanceStyle, mindBillThemePresets, parseBillSubmissionDate, resolveMindBillAppearance, useBillLifecycle, useBillStatus, validateBillSubmission, visibleBillLifecycleActions };