@mindbill/react 0.77.62 → 0.77.64

package/dist/index.d.ts

@@ -227,6 +227,8 @@ type BillSubmissionProcedureOption = {
     code: string;
     description: string;
     allowedAmount?: number;
+    /** Units a line starts with when this code is chosen, for services with a customary or minimum quantity. */
+    defaultUnits?: number;
 };
 type BillSubmissionModifierOption = {
     code: string;
@@ -437,6 +439,11 @@ type BillSubmissionFormProps = {
     procedureOptions?: BillSubmissionProcedureOption[];
     /** Extend the existing procedure picker with treatment codes and authoritative fee quotes. */
     treatmentBilling?: boolean;
+    /** Lines added when a procedure is chosen, keyed by that procedure's code. A code already on the bill is not added again. */
+    companionLines?: Readonly<Record<string, readonly {
+        code: string;
+        units?: number;
+    }[]>>;
     /** Opt in to editable treatment billed charges; fee quotes remain separate estimates. */
     editableTreatmentCharges?: boolean;
     onSearchProcedureCodes?: (input?: BillProcedureCodeSearchInput) => Promise<BillProcedureCodePage>;
@@ -522,7 +529,7 @@ declare function BillSubmissionProvidersSection(): ReactElement;
 declare function BillSubmissionServiceLinesSection(): ReactElement;
 declare function BillSubmissionAttachmentsSection(): ReactElement;
 declare function BillSubmissionActions(): ReactElement;
-declare function BillSubmissionForm({ initialBill, idempotencyKey, attachments, onSubmit, onSubmitted, getSession, sessionEndpoint, apiBaseUrl, profileOptions, billingSettings, reportAutofill, profileDisplay, fetch: fetchOverride, onListMedicalProviderNetworks, onListClaimsAdministrators, onSearchClaimsAdministrators, onGetClaimsAdministratorDirectory, claimsAdministratorSources, claimsAdministratorHint, diagnosisOptions, onSearchDiagnoses, onLookupPostalCode, procedureOptions, treatmentBilling, editableTreatmentCharges, onSearchProcedureCodes, onQuoteFee, modifierOptions, taxonomyOptions, deliveryRoutePicker, deliveryRouteDialogTitle, attachmentReportTypeMode, attachmentReportTypes, defaultAttachmentReportType, appearance, className, style, disabled, submitLabel, heading, description, attentionFields, attentionMessage, children, }: BillSubmissionFormProps): ReactElement;
+declare function BillSubmissionForm({ initialBill, idempotencyKey, attachments, onSubmit, onSubmitted, getSession, sessionEndpoint, apiBaseUrl, profileOptions, billingSettings, reportAutofill, profileDisplay, fetch: fetchOverride, onListMedicalProviderNetworks, onListClaimsAdministrators, onSearchClaimsAdministrators, onGetClaimsAdministratorDirectory, claimsAdministratorSources, claimsAdministratorHint, diagnosisOptions, onSearchDiagnoses, onLookupPostalCode, procedureOptions, treatmentBilling, companionLines, editableTreatmentCharges, onSearchProcedureCodes, onQuoteFee, modifierOptions, taxonomyOptions, deliveryRoutePicker, deliveryRouteDialogTitle, attachmentReportTypeMode, attachmentReportTypes, defaultAttachmentReportType, appearance, className, style, disabled, submitLabel, heading, description, attentionFields, attentionMessage, children, }: BillSubmissionFormProps): ReactElement;
 
 type BillSubmissionProfileOption<K extends "billingProvider" | "renderingProvider" | "serviceLocation"> = {
     id: string;

package/dist/index.js

@@ -2423,7 +2423,14 @@ var messages = {
   telehealth_modifier_requires_ground_rule_review: "This telehealth modifier needs fee review for the service date.",
   conflicting_telehealth_modifiers: "Review the telehealth modifiers; the selected modes conflict.",
   telehealth_modifier_93_not_adopted_for_date: "Audio-only modifier 93 is not adopted for this service date. Review the dated telehealth rules.",
-  telehealth_modifier_required: "Select the telehealth modifier that matches the service and its date."
+  telehealth_modifier_required: "Select the telehealth modifier that matches the service and its date.",
+  timed_testing_add_on_requires_primary_service: "Add the first-hour or first-30-minute testing code for the same date; this code is billed only with it.",
+  timed_testing_units_exceed_adopted_mue: "The units are above the daily limit for this code. Lower the units, or submit with documentation for review.",
+  timed_testing_unit_limit_unverified: "The daily unit limit for this code could not be confirmed for this service date.",
+  timed_testing_indicators_or_modifiers_require_review: "Remove the modifiers from this testing code to get an automatic fee, or submit it for review.",
+  modifier_requires_ground_rule_review: "This modifier changes how the fee is calculated and needs review.",
+  physician_service_context_required_or_adjustment_not_supported: "This service is billed with other same-day services and needs fee review.",
+  separate_schedule_or_payment_formula_required: "This code is paid under a separate schedule and needs fee review."
 };
 function feeReviewMessage(reason) {
   if (!reason) return "Checking the fee schedule\u2026";
@@ -8213,6 +8220,7 @@ function billSubmissionCalculationContext(code, placeOfService, details, saved =
   return context;
 }
 var isMedicalLegalCode = (code) => /^ML/i.test(code.trim());
+var billingModeForLines = (lines) => lines.some((line) => isMedicalLegalCode(line.code)) ? "med_legal" : "professional";
 function billSubmissionFeeRequest(bill, line, context = line.feeContext ?? {}) {
   const dateOfService = parseBillSubmissionDate(line.serviceDate ?? bill.service.date) ?? "";
   const sameDayServices = bill.serviceLines.filter((candidate) => candidate.code.trim() && parseBillSubmissionDate(candidate.serviceDate ?? bill.service.date) === dateOfService);
@@ -8376,6 +8384,19 @@ function blankLine() {
 function lineHasContent(line) {
   return Boolean(line.code.trim() || line.modifiers?.length || line.charge != null || line.drug || line.formData);
 }
+function withAddedBillSubmissionLines(lines, added) {
+  if (!added?.length) return lines;
+  const entered = [...lines];
+  while (entered.length && !lineHasContent(entered.at(-1))) entered.pop();
+  const present = new Set(entered.map((line) => line.code.trim().toUpperCase()));
+  for (const line of added) {
+    const code = line.code.trim().toUpperCase();
+    if (!code || present.has(code)) continue;
+    present.add(code);
+    entered.push({ code, modifiers: [], units: line.units ?? 1 });
+  }
+  return entered;
+}
 function ensureTrailingBillSubmissionLine(lines) {
   const normalized = lines.length ? lines.map((line) => ({ ...line, modifiers: [...line.modifiers ?? []], units: line.units ?? 1 })) : [];
   while (normalized.length > 1 && !lineHasContent(normalized.at(-1)) && !lineHasContent(normalized.at(-2))) normalized.pop();
@@ -8485,7 +8506,7 @@ function setBillSubmissionLineDiagnoses(bill, index, codes2) {
 }
 function cloneInitialBill(bill, treatmentBilling = false) {
   const cloned = cloneBill(bill);
-  if (treatmentBilling && cloned.serviceLines.some((line) => line.code.trim() && !isMedicalLegalCode(line.code))) cloned.billingMode = "professional";
+  if (treatmentBilling && cloned.serviceLines.some((line) => line.code.trim())) cloned.billingMode = billingModeForLines(cloned.serviceLines);
   if (cloned.billingMode !== "professional") cloned.diagnoses = applyBillSubmissionEvaluationDiagnoses(cloned.diagnoses, initialEvaluationType(bill));
   return billSubmissionUsesSharedDiagnoses(cloned) ? setBillSubmissionSharedDiagnoses(cloned, cloned.diagnoses ?? []) : cloned;
 }
@@ -8574,14 +8595,13 @@ function validateBillSubmission(bill) {
   if (bill.renderingProvider?.taxonomy && !/^[A-Za-z0-9]{10}$/.test(bill.renderingProvider.taxonomy.trim())) errors["renderingProvider.taxonomy"] = "Enter a valid 10-character taxonomy code.";
   if (bill.serviceLocation?.placeOfServiceCode && !/^\d{2}$/.test(bill.serviceLocation.placeOfServiceCode.trim())) errors["serviceLocation.placeOfServiceCode"] = "Enter a valid 2-digit place of service code.";
   const lines = submittedLines(bill.serviceLines);
-  if (lines.some((line) => isMedicalLegalCode(line.code)) && lines.some((line) => line.code && !isMedicalLegalCode(line.code))) errors.serviceLines = "Submit medical-legal and treatment services on separate bills.";
   if (!lines.length) errors.serviceLines = "Add at least one service line";
   lines.forEach((line, index) => {
     required2(`serviceLines.${index}.code`, line.code, "Select a procedure code.");
     const pointers = line.diagnosisPointers ?? [];
     if (pointers.length > 4 || new Set(pointers).size !== pointers.length || pointers.some((pointer) => !Number.isInteger(pointer) || pointer < 1 || pointer > (bill.diagnoses?.length ?? 0)) || bill.billingMode === "professional" && !pointers.length) errors[`serviceLines.${index}.diagnosisPointers`] = "Select up to four diagnoses for this service line.";
     if (!Number.isInteger(line.units) || (line.units ?? 0) < 1) errors[`serviceLines.${index}.units`] = "Enter at least 1 unit";
-    if (bill.billingMode === "professional" && (!Number.isFinite(line.charge) || (line.charge ?? 0) <= 0)) errors[`serviceLines.${index}.charge`] = "Enter the billed charge";
+    if ((bill.billingMode === "professional" || !isMedicalLegalCode(line.code) && lines.some((other) => isMedicalLegalCode(other.code))) && (!Number.isFinite(line.charge) || (line.charge ?? 0) <= 0)) errors[`serviceLines.${index}.charge`] = "Enter the billed charge";
   });
   return { valid: Object.keys(errors).length === 0, fieldErrors: errors };
 }
@@ -8640,15 +8660,15 @@ function TextDateInput({ value, onChange, disabled, required: required2, ariaLab
     invalid ? /* @__PURE__ */ jsx20("small", { className: "mbsf-error", children: "Use MM/DD/YYYY" }) : null
   ] });
 }
-function ComboBox({ value, placeholder, options, disabled, loading, loadingMore, invalid, preserveValueOnOpen = false, filterOptions = true, onOpen, onQuery, onEndReached, onSelect, createOption, ariaLabel }) {
+function ComboBox({ value, placeholder, options, disabled, loading, loadingMore, invalid, preserveValueOnOpen = false, filterOptions = true, matchCodeIgnoringSeparators = false, onOpen, onQuery, onEndReached, onSelect, createOption, ariaLabel }) {
   const [open, setOpen] = useState12(false);
   const [query, setQuery] = useState12("");
   const visible = useMemo6(() => {
     const q = query.trim().toLowerCase();
-    const matches = q && filterOptions ? options.filter((option) => `${option.id} ${option.label} ${option.detail ?? ""} ${(option.badges ?? []).join(" ")} ${(option.affiliatedEntities ?? []).join(" ")} ${option.trailing ?? ""}`.toLowerCase().includes(q)) : options;
+    const matches = q && filterOptions ? options.filter((option) => `${option.id} ${option.label} ${option.detail ?? ""} ${(option.badges ?? []).join(" ")} ${(option.affiliatedEntities ?? []).join(" ")} ${option.trailing ?? ""}`.toLowerCase().includes(q) || matchCodeIgnoringSeparators && /[\s-]/.test(q) && option.id.toLowerCase().includes(q.replace(/[\s-]+/g, ""))) : options;
     const custom = createOption?.(query) ?? null;
     return custom && !matches.some((option) => option.id.toUpperCase() === custom.id.toUpperCase()) ? [...matches, custom] : matches;
-  }, [createOption, filterOptions, options, query]);
+  }, [createOption, filterOptions, matchCodeIgnoringSeparators, options, query]);
   const showMenu = open;
   return /* @__PURE__ */ jsxs19("div", { className: "mbsf-combo", children: [
     /* @__PURE__ */ jsx20("input", { className: "mbsf-input", role: "combobox", "aria-label": ariaLabel, "aria-invalid": invalid, "aria-expanded": showMenu, autoComplete: "off", disabled, placeholder, value: open ? query : value, onFocus: () => {
@@ -8707,7 +8727,7 @@ function focusFirstInvalid(form) {
   }
 }
 function customProcedureOption(query) {
-  const code = query.trim().toUpperCase().replace(/\s+/g, "");
+  const code = query.trim().toUpperCase().replace(/[\s-]+/g, "");
   if (!/^(?:\d{5}|[A-Z]\d{4}|WC\d{3}|ML(?:20[0-5]|PRR))$/.test(code)) return null;
   return { id: code, label: code, detail: "Use this CPT, HCPCS, or medical-legal code" };
 }
@@ -8808,6 +8828,7 @@ function BillSubmissionForm({
   onLookupPostalCode,
   procedureOptions,
   treatmentBilling = false,
+  companionLines,
   editableTreatmentCharges = false,
   onSearchProcedureCodes,
   onQuoteFee,
@@ -8898,7 +8919,7 @@ function BillSubmissionForm({
   const diagnosisAppendPending = useRef8(false);
   const payerRequest = useRef8(0);
   const payerAppendPending = useRef8(false);
-  const procedures = useMemo6(() => mergeOptions(DEFAULT_BILL_SUBMISSION_PROCEDURES, [...procedureOptions ?? [], ...procedureResults, ...treatmentBilling ? [{ code: "WC002", description: "Progress report" }, { code: "WC003", description: "Permanent and stationary report (PR-3)" }, { code: "WC004", description: "Permanent and stationary report (PR-4)" }] : []]), [procedureOptions, procedureResults, treatmentBilling]);
+  const procedures = useMemo6(() => mergeOptions(DEFAULT_BILL_SUBMISSION_PROCEDURES, [...procedureResults.filter((result) => !DEFAULT_BILL_SUBMISSION_PROCEDURES.some((item) => item.code.toUpperCase() === result.code.toUpperCase())), ...procedureOptions ?? [], ...treatmentBilling ? [{ code: "WC002", description: "Progress report" }, { code: "WC003", description: "Permanent and stationary report (PR-3)" }, { code: "WC004", description: "Permanent and stationary report (PR-4)" }] : []]), [procedureOptions, procedureResults, treatmentBilling]);
   const orderedClaimsAdministratorSources = useMemo6(() => [...claimsAdministratorSources ?? []].filter((source) => source.name.trim()).sort((left, right) => Number(right.source.toLowerCase() === "eams") - Number(left.source.toLowerCase() === "eams")), [claimsAdministratorSources]);
   const sourceClaimsAdministratorName = orderedClaimsAdministratorSources[0]?.name.trim() ?? "";
   const initializationKey = useMemo6(
@@ -9029,7 +9050,8 @@ function BillSubmissionForm({
     if (Object.hasOwn(patch, "modifiers")) setFeeDetails((current) => ({ ...current, [index]: { ...detailsForLine(index), interpretationLocation: "", professionalComponentBasis: "" } }));
     if (Object.hasOwn(patch, "code")) setFeeDetails((current) => ({ ...current, [index]: {} }));
     setBill((current) => {
-      const serviceLines = ensureTrailingBillSubmissionLine(current.serviceLines.map((line, lineIndex) => {
+      const added = patch.code != null && patch.code !== current.serviceLines[index]?.code ? Object.entries(companionLines ?? {}).find(([code]) => code.trim().toUpperCase() === patch.code.trim().toUpperCase())?.[1] : void 0;
+      const serviceLines = ensureTrailingBillSubmissionLine(withAddedBillSubmissionLines(current.serviceLines.map((line, lineIndex) => {
         if (lineIndex !== index) return line;
         const next = { ...line, ...patch };
         if (patch.code != null && patch.code !== line.code) {
@@ -9037,6 +9059,10 @@ function BillSubmissionForm({
           delete next.feeContext;
           delete next.drug;
         }
+        if (patch.code != null && patch.code !== line.code && (patch.units === void 0 || patch.units === line.units)) {
+          const startingUnits = (code) => procedures.find((item) => item.code.toUpperCase() === code.trim().toUpperCase())?.defaultUnits ?? 1;
+          if ((line.units ?? 1) === startingUnits(line.code)) next.units = startingUnits(patch.code);
+        }
         if (treatmentBilling && next.code && !isMedicalLegalCode(next.code)) {
           if (!editableTreatmentCharges || patch.code != null && patch.code !== line.code) delete next.charge;
           return next;
@@ -9045,9 +9071,9 @@ function BillSubmissionForm({
         if (charge != null) return { ...next, charge };
         if (Object.hasOwn(patch, "code")) delete next.charge;
         return next;
-      }));
+      }), added));
       const populated = serviceLines.filter((line) => line.code.trim());
-      return { ...sharedDiagnoses ? setBillSubmissionSharedDiagnoses(replaceBillSubmissionServiceLines(current, serviceLines), current.diagnoses ?? []) : replaceBillSubmissionServiceLines(current, serviceLines), ...treatmentBilling && populated.length ? { billingMode: populated.every((line) => isMedicalLegalCode(line.code)) ? "med_legal" : "professional" } : {} };
+      return { ...sharedDiagnoses ? setBillSubmissionSharedDiagnoses(replaceBillSubmissionServiceLines(current, serviceLines), current.diagnoses ?? []) : replaceBillSubmissionServiceLines(current, serviceLines), ...treatmentBilling && populated.length ? { billingMode: billingModeForLines(populated) } : {} };
     });
   };
   const setLineCharge = (index, charge) => setBill((current) => ({
@@ -9405,7 +9431,7 @@ function BillSubmissionForm({
     } else if (charge != null) next.charge = charge;
     return next;
   }).filter(lineHasContent);
-  const clean = { ...cloneBill(bill), serviceLines: pricedLines, ...treatmentBilling && pricedLines.length ? { billingMode: pricedLines.every((line) => isMedicalLegalCode(line.code)) ? "med_legal" : "professional" } : {} };
+  const clean = { ...cloneBill(bill), serviceLines: pricedLines, ...treatmentBilling && pricedLines.length ? { billingMode: billingModeForLines(pricedLines) } : {} };
   const previewBillKey = JSON.stringify(clean);
   const previewCurrent = cmsPreview?.billKey === previewBillKey;
   const liveErrors = JSON.stringify(validateBillSubmission(clean).fieldErrors);
@@ -9829,7 +9855,7 @@ function BillSubmissionForm({
       ] }),
       bill.serviceLines.map((line, index) => /* @__PURE__ */ jsxs19("div", { className: "mbsf-line", children: [
         /* @__PURE__ */ jsxs19("div", { "data-label": "Procedure code", "data-field-path": `serviceLines.${index}.code`, "data-invalid": Boolean(errors[`serviceLines.${index}.code`]), children: [
-          /* @__PURE__ */ jsx20(ComboBox, { ariaLabel: `Procedure code ${index + 1}`, invalid: Boolean(errors[`serviceLines.${index}.code`]), disabled: locked, value: line.code, placeholder: "Search or enter code\u2026", loading: procedureLoading, onOpen: () => loadProcedures(""), onQuery: loadProcedures, options: procedures.map((item) => ({ id: item.code, label: item.code, detail: item.description })), createOption: customProcedureOption, onSelect: (option) => {
+          /* @__PURE__ */ jsx20(ComboBox, { ariaLabel: `Procedure code ${index + 1}`, invalid: Boolean(errors[`serviceLines.${index}.code`]), disabled: locked, value: line.code, placeholder: "Search or enter code\u2026", matchCodeIgnoringSeparators: true, loading: procedureLoading, onOpen: () => loadProcedures(""), onQuery: loadProcedures, options: procedures.map((item) => ({ id: item.code, label: item.code, detail: item.description })), createOption: customProcedureOption, onSelect: (option) => {
             const switched = isMedicalLegalCode(line.code) && !isMedicalLegalCode(option.id);
             const [updated] = applyBillSubmissionEvaluationModifiers([{ ...line, code: option.id, ...switched ? { modifiers: (line.modifiers ?? []).filter((value) => !["94", "95", "96"].includes(value.replace(/^-/, ""))) } : {} }], evaluationType);
             setLine(index, updated);
@@ -9853,7 +9879,7 @@ function BillSubmissionForm({
           /* @__PURE__ */ jsx20("input", { className: "mbsf-input", "aria-label": `Units ${index + 1}`, "aria-invalid": Boolean(errors[`serviceLines.${index}.units`]), type: "number", min: 1, max: treatmentBilling && isAnesthesiaCandidate(line.code) ? 1 : void 0, value: line.units ?? 1, onChange: (event) => setLine(index, { units: Number(event.target.value) }) }),
           errors[`serviceLines.${index}.units`] ? /* @__PURE__ */ jsx20("small", { className: "mbsf-error", role: "alert", children: errors[`serviceLines.${index}.units`] }) : null
         ] }),
-        /* @__PURE__ */ jsx20("div", { className: "mbsf-money", "data-label": editableTreatmentCharges && treatmentBilling ? "Billed charge" : "Allowed", "data-field-path": `serviceLines.${index}.charge`, "data-invalid": Boolean(errors[`serviceLines.${index}.charge`]), children: lineCharge(line, index) == null ? quoteKeys[index] ? !supportedFeeJurisdiction || !quoteFee || !quoteInputs[index]?.dateOfService || isTherapyEditorCode(line.code) && !quoteInputs[index]?.therapyContext || feeQuotes[quoteKeys[index]] ? "Needs review" : "Checking\u2026" : "\u2014" : lineCharge(line, index).toLocaleString(void 0, { style: "currency", currency: "USD" }) }),
+        /* @__PURE__ */ jsx20("div", { className: "mbsf-money", "data-label": editableTreatmentCharges && treatmentBilling ? "Billed charge" : "Allowed", "data-field-path": `serviceLines.${index}.charge`, "data-invalid": Boolean(errors[`serviceLines.${index}.charge`]), children: lineCharge(line, index) == null ? quoteKeys[index] ? !supportedFeeJurisdiction || !quoteFee || !quoteInputs[index]?.dateOfService || isTherapyEditorCode(line.code) && !quoteInputs[index]?.therapyContext ? "Needs review" : feeQuotes[quoteKeys[index]]?.status === "error" ? "Fee unavailable" : feeQuotes[quoteKeys[index]] ? "Needs review" : "Checking\u2026" : "\u2014" : lineCharge(line, index).toLocaleString(void 0, { style: "currency", currency: "USD" }) }),
         /* @__PURE__ */ jsx20("button", { className: "mbsf-icon-btn", type: "button", "aria-label": `Remove service line ${index + 1}`, disabled: locked || !lineHasContent(line) && index === bill.serviceLines.length - 1, onClick: () => {
           setFeeDetails({});
           if (individualDiagnoses.current) individualDiagnoses.current.splice(index, 1);
@@ -20056,7 +20082,7 @@ function ConnectedBillLifecycle({
           initialBill: correctionInitialBill,
           profileOptions: data.options ? organizationProfileOptions(data.options) : {},
           ...billingSettings ? { billingSettings } : {},
-          treatmentBilling: data.bill.billingMode === "professional",
+          treatmentBilling: data.bill.billingMode === "professional" || data.bill.lineItems.some((line) => !/^ML/i.test(line.code.trim())),
           attachments: correctionAttachments,
           onSubmit: submitCorrection,
           onListMedicalProviderNetworks: lifecycle.listMedicalProviderNetworks,
@@ -20097,7 +20123,7 @@ function ConnectedBillLifecycle({
           initialBill: correctionInitialBill,
           profileOptions: data.options ? organizationProfileOptions(data.options) : {},
           ...billingSettings ? { billingSettings } : {},
-          treatmentBilling: data.bill.billingMode === "professional",
+          treatmentBilling: data.bill.billingMode === "professional" || data.bill.lineItems.some((line) => !/^ML/i.test(line.code.trim())),
           attachments: correctionAttachments,
           onSubmit: submitNewBillFromForm,
           onListMedicalProviderNetworks: lifecycle.listMedicalProviderNetworks,
@@ -20221,7 +20247,7 @@ function ConnectedBillLifecycle({
           initialBill: correctionInitialBill,
           profileOptions: data.options ? organizationProfileOptions(data.options) : {},
           ...billingSettings ? { billingSettings } : {},
-          treatmentBilling: data.bill.billingMode === "professional",
+          treatmentBilling: data.bill.billingMode === "professional" || data.bill.lineItems.some((line) => !/^ML/i.test(line.code.trim())),
           attachments: correctionAttachments,
           onSubmit: submitDuplicateFromForm,
           onListMedicalProviderNetworks: lifecycle.listMedicalProviderNetworks,