@mindbill/react 0.24.0 → 0.26.0

package/dist/index.js

@@ -2,7 +2,7 @@
 
 // src/index.tsx
 import "@mindbill/embed";
-import { createElement, useEffect as useEffect5, useRef as useRef5 } from "react";
+import { createElement, useEffect as useEffect6, useRef as useRef5 } from "react";
 
 // src/appearance.ts
 var mindBillThemePresets = {
@@ -1044,6 +1044,7 @@ var NATIVE_THEME_OVERRIDE_STYLES = `
 `;
 
 // src/bill-read-only-form.tsx
+import { useEffect as useEffect2, useState as useState2 } from "react";
 import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 function money2(value) {
   return new Intl.NumberFormat(void 0, { style: "currency", currency: "USD" }).format(value);
@@ -1060,13 +1061,25 @@ function Value({ label, children, wide = false }) {
   ] });
 }
 function BillReadOnlyForm({ data, appearance, className, style, onOpenAttachment }) {
+  const [payerOpen, setPayerOpen] = useState2(false);
   const { bill, patient, injury } = data;
   const provider = bill.billingSnapshot?.billingProvider;
   const clinician = bill.billingSnapshot?.renderingProvider;
   const location = bill.billingSnapshot?.placeOfService;
   const address = patient.address;
   const patientAddress = [address?.line1, address?.city, address?.state, address?.postalCode].filter(Boolean).join(", ");
+  const billingAddress = provider ? [provider.billingStreet, provider.billingCity, provider.billingState, provider.billingZip].filter(Boolean).join(", ") : "";
   const locationAddress = location ? [location.street, location.city, location.state, location.zip].filter(Boolean).join(", ") : "";
+  const payerName = data.delivery?.payerName || injury.claimsAdminName || "\u2014";
+  const contacts = data.delivery?.contacts;
+  useEffect2(() => {
+    if (!payerOpen) return;
+    const close = (event) => {
+      if (event.key === "Escape") setPayerOpen(false);
+    };
+    window.addEventListener("keydown", close);
+    return () => window.removeEventListener("keydown", close);
+  }, [payerOpen]);
   return /* @__PURE__ */ jsxs2("section", { className: ["mb-readonly-bill", className].filter(Boolean).join(" "), style: mindBillAppearanceStyle(appearance, style), "aria-label": "Bill details", children: [
     /* @__PURE__ */ jsx2("style", { children: READ_ONLY_STYLES }),
     /* @__PURE__ */ jsxs2("header", { className: "mb-readonly-heading", children: [
@@ -1090,7 +1103,7 @@ function BillReadOnlyForm({ data, appearance, className, style, onOpenAttachment
       /* @__PURE__ */ jsxs2("dl", { className: "mb-read-grid", children: [
         /* @__PURE__ */ jsx2(Value, { label: "Claim number", children: injury.claimNumber }),
         /* @__PURE__ */ jsx2(Value, { label: "WCAB / ADJ number", children: injury.adjNumber }),
-        /* @__PURE__ */ jsx2(Value, { label: "Claims administrator", children: injury.claimsAdminName }),
+        /* @__PURE__ */ jsx2(Value, { label: "Claims administrator", children: /* @__PURE__ */ jsx2("button", { type: "button", className: "mb-read-payer", onClick: () => setPayerOpen(true), children: payerName }) }),
         /* @__PURE__ */ jsx2(Value, { label: "Employer", children: injury.employer }),
         /* @__PURE__ */ jsx2(Value, { label: "Date of injury", children: date(injury.doi) }),
         /* @__PURE__ */ jsx2(Value, { label: "Date of service", children: bill.dosEnd ? `${date(bill.dos)} \u2013 ${date(bill.dosEnd)}` : date(bill.dos) }),
@@ -1103,10 +1116,13 @@ function BillReadOnlyForm({ data, appearance, className, style, onOpenAttachment
       /* @__PURE__ */ jsxs2("dl", { className: "mb-read-grid", children: [
         /* @__PURE__ */ jsx2(Value, { label: "Billing provider", children: provider?.name }),
         /* @__PURE__ */ jsx2(Value, { label: "Billing NPI", children: provider?.npi }),
+        /* @__PURE__ */ jsx2(Value, { label: "Billing tax ID", children: provider?.taxId }),
+        /* @__PURE__ */ jsx2(Value, { label: "Billing phone", children: provider?.phone }),
+        /* @__PURE__ */ jsx2(Value, { label: "Billing address", wide: true, children: billingAddress }),
         /* @__PURE__ */ jsx2(Value, { label: "Rendering provider", children: clinician?.name }),
         /* @__PURE__ */ jsx2(Value, { label: "Rendering NPI", children: clinician?.npi }),
-        /* @__PURE__ */ jsx2(Value, { label: "Specialty", children: clinician?.specialty }),
-        /* @__PURE__ */ jsx2(Value, { label: "Place of service", children: location?.name }),
+        /* @__PURE__ */ jsx2(Value, { label: "Rendering taxonomy", children: clinician?.taxonomy }),
+        /* @__PURE__ */ jsx2(Value, { label: "Place of service code", children: location?.posCode }),
         /* @__PURE__ */ jsx2(Value, { label: "Service address", wide: true, children: locationAddress })
       ] })
     ] }),
@@ -1144,18 +1160,39 @@ function BillReadOnlyForm({ data, appearance, className, style, onOpenAttachment
           /* @__PURE__ */ jsx2("strong", { children: attachment.filename }),
           /* @__PURE__ */ jsx2("span", { children: attachment.description || attachment.documentType.replace(/_/g, " ") })
         ] }),
-        onOpenAttachment ? /* @__PURE__ */ jsx2("button", { type: "button", onClick: () => void onOpenAttachment(attachment), children: "View" }) : null
+        onOpenAttachment ? /* @__PURE__ */ jsx2("button", { type: "button", onClick: () => void onOpenAttachment(attachment), children: "Preview" }) : null
       ] }, attachment.id)) }) : /* @__PURE__ */ jsx2("p", { className: "mb-read-empty", children: "No attachments." })
-    ] })
+    ] }),
+    payerOpen ? /* @__PURE__ */ jsx2("div", { className: "mb-read-dialog-backdrop", role: "presentation", onMouseDown: (event) => {
+      if (event.target === event.currentTarget) setPayerOpen(false);
+    }, children: /* @__PURE__ */ jsxs2("section", { className: "mb-read-dialog", role: "dialog", "aria-modal": "true", "aria-labelledby": "mb-read-payer-title", children: [
+      /* @__PURE__ */ jsxs2("header", { children: [
+        /* @__PURE__ */ jsxs2("div", { children: [
+          /* @__PURE__ */ jsx2("span", { children: "Claims administrator" }),
+          /* @__PURE__ */ jsx2("h3", { id: "mb-read-payer-title", children: payerName })
+        ] }),
+        /* @__PURE__ */ jsx2("button", { type: "button", "aria-label": "Close claims administrator details", onClick: () => setPayerOpen(false), children: "\xD7" })
+      ] }),
+      /* @__PURE__ */ jsxs2("dl", { className: "mb-read-contact-grid", children: [
+        /* @__PURE__ */ jsx2(Value, { label: "Adjuster", children: contacts?.adjusterName }),
+        /* @__PURE__ */ jsx2(Value, { label: "Adjuster phone", children: contacts?.adjusterPhone }),
+        /* @__PURE__ */ jsx2(Value, { label: "Adjuster email", children: contacts?.adjusterEmail }),
+        /* @__PURE__ */ jsx2(Value, { label: "Claims email", children: contacts?.claimsEmail }),
+        /* @__PURE__ */ jsx2(Value, { label: "Fax", children: contacts?.faxNumber }),
+        /* @__PURE__ */ jsx2(Value, { label: "Portal", children: contacts?.portalUrl ? /* @__PURE__ */ jsx2("a", { href: contacts.portalUrl, target: "_blank", rel: "noopener noreferrer", children: "Open payer portal" }) : "\u2014" }),
+        /* @__PURE__ */ jsx2(Value, { label: "Mailing address", wide: true, children: contacts?.mailingAddress })
+      ] }),
+      !contacts || !Object.values(contacts).some(Boolean) ? /* @__PURE__ */ jsx2("p", { className: "mb-read-empty", children: "No contact details are available for this directory entry." }) : null
+    ] }) }) : null
   ] });
 }
 var READ_ONLY_STYLES = `
-.mb-readonly-bill{--mb-accent:#176c70;--mb-border:#d7e0df;--mb-surface:#fff;--mb-muted:#607176;color:var(--mb-text,#17282d);font:inherit;display:grid;gap:16px}.mb-readonly-heading{display:flex;align-items:flex-end;justify-content:space-between;gap:20px}.mb-readonly-heading h2,.mb-read-card h3{margin:0}.mb-readonly-heading p{margin:4px 0 0;color:var(--mb-muted)}.mb-readonly-heading>strong{font-size:1.35rem}.mb-read-card{background:var(--mb-surface);border:1px solid var(--mb-border);border-radius:var(--mb-radius,14px);padding:20px;box-shadow:0 1px 2px rgba(15,40,45,.04)}.mb-read-card h3{font-size:1.05rem;margin-bottom:16px}.mb-read-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:17px 28px;margin:0}.mb-read-value{min-width:0}.mb-read-value.is-wide{grid-column:1/-1}.mb-read-value dt{color:var(--mb-muted);font-size:.75rem;font-weight:700;letter-spacing:.07em;text-transform:uppercase}.mb-read-value dd{font-weight:600;margin:5px 0 0;overflow-wrap:anywhere}.mb-read-chips{display:flex;flex-wrap:wrap;gap:6px;margin-top:16px}.mb-read-chips span{border:1px solid var(--mb-border);border-radius:999px;padding:3px 9px;font-size:.82rem;background:#f7f9f8}.mb-read-lines{border:1px solid var(--mb-border);border-radius:10px;overflow:hidden}.mb-read-line-header,.mb-read-line{display:grid;grid-template-columns:1.2fr 1.5fr .45fr .7fr;gap:16px;align-items:center;padding:12px 14px}.mb-read-line-header{background:#f6f8f7;color:var(--mb-muted);font-size:.75rem;font-weight:700;text-transform:uppercase}.mb-read-line{border-top:1px solid var(--mb-border)}.mb-read-line .mb-read-chips{margin:0}.mb-read-line>span:last-child,.mb-read-line>strong:last-child{text-align:right}.mb-read-total{display:flex;justify-content:flex-end;gap:24px;border-top:1px solid var(--mb-border);padding:13px 14px}.mb-read-documents{list-style:none;padding:0;margin:0;display:grid}.mb-read-documents li{display:flex;align-items:center;justify-content:space-between;gap:16px;padding:13px 0;border-top:1px solid var(--mb-border)}.mb-read-documents li:first-child{border-top:0;padding-top:0}.mb-read-documents li:last-child{padding-bottom:0}.mb-read-documents div{display:grid;gap:3px;min-width:0}.mb-read-documents strong{overflow-wrap:anywhere}.mb-read-documents span,.mb-read-empty{color:var(--mb-muted)}.mb-read-documents button{border:1px solid var(--mb-border);border-radius:8px;background:transparent;color:inherit;padding:8px 13px;font:inherit;font-weight:650;cursor:pointer}.mb-read-documents button:hover{border-color:var(--mb-accent);color:var(--mb-accent)}
-@media(max-width:700px){.mb-readonly-heading{align-items:flex-start}.mb-read-grid{grid-template-columns:1fr}.mb-read-value.is-wide{grid-column:auto}.mb-read-card{padding:16px}.mb-read-line-header{display:none}.mb-read-line{grid-template-columns:1fr auto;gap:8px}.mb-read-line>*:nth-child(2){grid-column:1/-1}.mb-read-total{justify-content:space-between}.mb-readonly-heading>strong{font-size:1.05rem}}
+.mb-readonly-bill{--mb-accent:#176c70;--mb-border:#d7e0df;--mb-surface:#fff;--mb-muted:#607176;color:var(--mb-text,#17282d);font:inherit;display:grid;gap:16px}.mb-readonly-heading{display:flex;align-items:flex-end;justify-content:space-between;gap:20px}.mb-readonly-heading h2,.mb-read-card h3{margin:0}.mb-readonly-heading p{margin:4px 0 0;color:var(--mb-muted)}.mb-readonly-heading>strong{font-size:1.35rem}.mb-read-card{background:var(--mb-surface);border:1px solid var(--mb-border);border-radius:var(--mb-radius,14px);padding:20px;box-shadow:0 1px 2px rgba(15,40,45,.04)}.mb-read-card h3{font-size:1.05rem;margin-bottom:16px}.mb-read-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:17px 28px;margin:0}.mb-read-value{min-width:0}.mb-read-value.is-wide{grid-column:1/-1}.mb-read-value dt{color:var(--mb-muted);font-size:.75rem;font-weight:700;letter-spacing:.07em;text-transform:uppercase}.mb-read-value dd{font-weight:600;margin:5px 0 0;overflow-wrap:anywhere}.mb-read-payer{border:0;border-bottom:1px dotted currentColor;background:transparent;color:inherit;padding:0;font:inherit;font-weight:inherit;text-align:left;cursor:pointer}.mb-read-payer:hover{color:var(--mb-accent)}.mb-read-chips{display:flex;flex-wrap:wrap;gap:6px;margin-top:16px}.mb-read-chips span{border:1px solid var(--mb-border);border-radius:999px;padding:3px 9px;font-size:.82rem;background:#f7f9f8}.mb-read-lines{border:1px solid var(--mb-border);border-radius:10px;overflow:hidden}.mb-read-line-header,.mb-read-line{display:grid;grid-template-columns:1.2fr 1.5fr .45fr .7fr;gap:16px;align-items:center;padding:12px 14px}.mb-read-line-header{background:#f6f8f7;color:var(--mb-muted);font-size:.75rem;font-weight:700;text-transform:uppercase}.mb-read-line{border-top:1px solid var(--mb-border)}.mb-read-line .mb-read-chips{margin:0}.mb-read-line>span:last-child,.mb-read-line>strong:last-child{text-align:right}.mb-read-total{display:flex;justify-content:flex-end;gap:24px;border-top:1px solid var(--mb-border);padding:13px 14px}.mb-read-documents{list-style:none;padding:0;margin:0;display:grid}.mb-read-documents li{display:flex;align-items:center;justify-content:space-between;gap:16px;padding:13px 0;border-top:1px solid var(--mb-border)}.mb-read-documents li:first-child{border-top:0;padding-top:0}.mb-read-documents li:last-child{padding-bottom:0}.mb-read-documents div{display:grid;gap:3px;min-width:0}.mb-read-documents strong{overflow-wrap:anywhere}.mb-read-documents span,.mb-read-empty{color:var(--mb-muted)}.mb-read-documents button{border:1px solid var(--mb-border);border-radius:8px;background:transparent;color:inherit;padding:8px 13px;font:inherit;font-weight:650;cursor:pointer}.mb-read-documents button:hover{border-color:var(--mb-accent);color:var(--mb-accent)}.mb-read-dialog-backdrop{position:fixed;inset:0;z-index:1000;display:grid;place-items:center;background:rgba(11,28,32,.46);padding:20px}.mb-read-dialog{width:min(620px,100%);max-height:min(760px,calc(100vh - 40px));overflow:auto;border:1px solid var(--mb-border);border-radius:var(--mb-radius,14px);background:var(--mb-surface);padding:22px;box-shadow:0 22px 70px rgba(8,25,29,.24)}.mb-read-dialog header{display:flex;align-items:flex-start;justify-content:space-between;gap:20px;margin-bottom:20px}.mb-read-dialog header span{color:var(--mb-muted);font-size:.75rem;font-weight:700;letter-spacing:.07em;text-transform:uppercase}.mb-read-dialog h3{margin:4px 0 0}.mb-read-dialog header button{border:0;background:transparent;color:inherit;font:inherit;font-size:1.7rem;line-height:1;cursor:pointer}.mb-read-contact-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:17px 28px;margin:0}.mb-read-contact-grid a{color:var(--mb-accent)}
+@media(max-width:700px){.mb-readonly-heading{align-items:flex-start}.mb-read-grid,.mb-read-contact-grid{grid-template-columns:1fr}.mb-read-value.is-wide{grid-column:auto}.mb-read-card{padding:16px}.mb-read-line-header{display:none}.mb-read-line{grid-template-columns:1fr auto;gap:8px}.mb-read-line>*:nth-child(2){grid-column:1/-1}.mb-read-total{justify-content:space-between}.mb-readonly-heading>strong{font-size:1.05rem}.mb-read-dialog-backdrop{place-items:end center;padding:0}.mb-read-dialog{width:100%;max-height:82vh;border-radius:18px 18px 0 0;padding:20px 18px calc(20px + env(safe-area-inset-bottom))}}
 `;
 
 // src/bill-submission-form.tsx
-import { createContext, useCallback, useContext, useEffect as useEffect2, useMemo as useMemo2, useRef as useRef2, useState as useState2 } from "react";
+import { createContext, useCallback, useContext, useEffect as useEffect3, useMemo as useMemo2, useRef as useRef2, useState as useState3 } from "react";
 import {
   createBillReferenceClient,
   createBillSubmissionClient
@@ -1232,6 +1269,46 @@ var DEFAULT_BILL_SUBMISSION_MODIFIERS = [
   { code: "XP", description: "Separate practitioner" },
   { code: "XU", description: "Unusual non-overlapping service" }
 ];
+var DEFAULT_BILL_SUBMISSION_TAXONOMIES = [
+  { code: "103G00000X", description: "Clinical Neuropsychologist" },
+  { code: "103T00000X", description: "Psychologist" },
+  { code: "111N00000X", description: "Chiropractor" },
+  { code: "122300000X", description: "Dentist" },
+  { code: "133V00000X", description: "Dietitian, Registered" },
+  { code: "163W00000X", description: "Registered Nurse" },
+  { code: "183500000X", description: "Pharmacist" },
+  { code: "207L00000X", description: "Anesthesiology" },
+  { code: "207P00000X", description: "Emergency Medicine" },
+  { code: "207Q00000X", description: "Family Medicine" },
+  { code: "207R00000X", description: "Internal Medicine" },
+  { code: "207RC0000X", description: "Cardiovascular Disease" },
+  { code: "207RN0300X", description: "Nephrology" },
+  { code: "207RP1001X", description: "Pulmonary Disease" },
+  { code: "207RR0500X", description: "Rheumatology" },
+  { code: "207T00000X", description: "Neurological Surgery" },
+  { code: "207X00000X", description: "Orthopaedic Surgery" },
+  { code: "207XS0117X", description: "Orthopaedic Surgery of the Spine" },
+  { code: "207Y00000X", description: "Otolaryngology" },
+  { code: "208000000X", description: "Pediatrics" },
+  { code: "208100000X", description: "Physical Medicine & Rehabilitation" },
+  { code: "2083X0100X", description: "Occupational Medicine" },
+  { code: "2084N0400X", description: "Neurology" },
+  { code: "2084P0800X", description: "Psychiatry" },
+  { code: "2084P0802X", description: "Addiction Psychiatry" },
+  { code: "2084P0804X", description: "Child & Adolescent Psychiatry" },
+  { code: "2084S0012X", description: "Sleep Medicine" },
+  { code: "2085R0202X", description: "Diagnostic Radiology" },
+  { code: "208600000X", description: "Surgery" },
+  { code: "2086S0105X", description: "Surgery of the Hand" },
+  { code: "208D00000X", description: "General Practice" },
+  { code: "208M00000X", description: "Hospitalist" },
+  { code: "208VP0000X", description: "Pain Medicine" },
+  { code: "213E00000X", description: "Podiatrist" },
+  { code: "225100000X", description: "Physical Therapist" },
+  { code: "225X00000X", description: "Occupational Therapist" },
+  { code: "363A00000X", description: "Physician Assistant" },
+  { code: "363L00000X", description: "Nurse Practitioner" }
+];
 var BILL_SUBMISSION_DIAGNOSIS_QUICK_PICKS = [
   { label: "Psych", code: "Z04.6", description: "General psychiatric examination requested by authority" },
   { label: "Back", code: "M54.50", description: "Low back pain, unspecified" },
@@ -1376,8 +1453,26 @@ var BILL_SUBMISSION_REQUIRED_FIELDS = [
   "patient.address.state",
   "patient.address.postalCode",
   "claim.claimNumber",
+  "claim.employer",
+  "claim.dateOfInjury",
   "claim.claimsAdministrator",
   "service.date",
+  "billingProvider.name",
+  "billingProvider.taxId",
+  "billingProvider.npi",
+  "billingProvider.phone",
+  "billingProvider.address.line1",
+  "billingProvider.address.city",
+  "billingProvider.address.state",
+  "billingProvider.address.postalCode",
+  "renderingProvider.name",
+  "renderingProvider.npi",
+  "renderingProvider.taxonomy",
+  "serviceLocation.placeOfServiceCode",
+  "serviceLocation.address.line1",
+  "serviceLocation.address.city",
+  "serviceLocation.address.state",
+  "serviceLocation.address.postalCode",
   "diagnoses[]",
   "serviceLines[].code",
   "serviceLines[].units"
@@ -1537,8 +1632,26 @@ function validateBillSubmission(bill) {
   required("patient.address.state", bill.patient.address.state, "Enter the patient's 2-letter state code.");
   required("patient.address.postalCode", bill.patient.address.postalCode, "Enter the patient's ZIP code.");
   required("claim.claimNumber", bill.claim.claimNumber, "Enter the claim number.");
+  required("claim.employer", bill.claim.employer, "Enter the employer name.");
+  required("claim.dateOfInjury", bill.claim.dateOfInjury, "Enter the date of injury.");
   required("claim.claimsAdministrator", bill.claim.claimsAdministrator?.name, "Select a claims administrator so MindBill can route this bill.");
   required("service.date", bill.service.date, "Enter the date of service.");
+  required("billingProvider.name", bill.billingProvider?.name, "Enter the billing provider name.");
+  required("billingProvider.taxId", bill.billingProvider?.taxId, "Enter the billing provider Tax ID (EIN or SSN).");
+  required("billingProvider.npi", bill.billingProvider?.npi, "Enter the billing provider NPI.");
+  required("billingProvider.phone", bill.billingProvider?.phone, "Enter the billing provider phone number.");
+  required("billingProvider.address.line1", bill.billingProvider?.address?.line1, "Enter the billing provider street address.");
+  required("billingProvider.address.city", bill.billingProvider?.address?.city, "Enter the billing provider city.");
+  required("billingProvider.address.state", bill.billingProvider?.address?.state, "Enter the billing provider 2-letter state code.");
+  required("billingProvider.address.postalCode", bill.billingProvider?.address?.postalCode, "Enter the billing provider ZIP code.");
+  required("renderingProvider.name", bill.renderingProvider?.name, "Enter the rendering provider name.");
+  required("renderingProvider.npi", bill.renderingProvider?.npi, "Enter the rendering provider NPI.");
+  required("renderingProvider.taxonomy", bill.renderingProvider?.taxonomy, "Enter the rendering provider taxonomy code.");
+  required("serviceLocation.placeOfServiceCode", bill.serviceLocation?.placeOfServiceCode, "Enter the 2-digit place of service code.");
+  required("serviceLocation.address.line1", bill.serviceLocation?.address?.line1, "Enter the service facility street address.");
+  required("serviceLocation.address.city", bill.serviceLocation?.address?.city, "Enter the service facility city.");
+  required("serviceLocation.address.state", bill.serviceLocation?.address?.state, "Enter the service facility 2-letter state code.");
+  required("serviceLocation.address.postalCode", bill.serviceLocation?.address?.postalCode, "Enter the service facility ZIP code.");
   if (!(bill.diagnoses ?? []).some((code) => code.trim())) {
     errors.diagnoses = "Select at least one ICD-10 diagnosis code.";
   }
@@ -1546,7 +1659,16 @@ function validateBillSubmission(bill) {
     errors["claim.claimsAdministrator"] = "Select a claims administrator from the payer directory.";
   }
   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";
+  if (bill.billingProvider?.address?.state && bill.billingProvider.address.state.trim().length !== 2) errors["billingProvider.address.state"] = "Use a 2-letter state code.";
+  if (bill.serviceLocation?.address?.state && bill.serviceLocation.address.state.trim().length !== 2) errors["serviceLocation.address.state"] = "Use a 2-letter state code.";
+  const digits = (value) => value?.replace(/\D/g, "") ?? "";
+  if (bill.billingProvider?.taxId && digits(bill.billingProvider.taxId).length !== 9) errors["billingProvider.taxId"] = "Enter a valid 9-digit EIN or SSN.";
+  if (bill.billingProvider?.npi && !/^\d{10}$/.test(digits(bill.billingProvider.npi))) errors["billingProvider.npi"] = "Enter a valid 10-digit NPI.";
+  if (bill.renderingProvider?.npi && !/^\d{10}$/.test(digits(bill.renderingProvider.npi))) errors["renderingProvider.npi"] = "Enter a valid 10-digit NPI.";
+  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.length) errors.serviceLines = "Add at least one service line";
   lines.forEach((line, index) => {
@@ -1559,7 +1681,7 @@ function validateBillSubmission(bill) {
 var css = `
 .mbsf{display:grid;gap:20px;color:var(--mb-text);font-family:var(--mb-font);font-size:15px}.mbsf *{box-sizing:border-box}
 .mbsf-head,.mbsf-section-head,.mbsf-attach-row,.mbsf-actions{display:flex;align-items:center;justify-content:space-between;gap:16px}.mbsf-title{margin:0;font-size:24px}.mbsf-copy,.mbsf-help{color:var(--mb-muted);margin:5px 0 0}.mbsf-required{font-size:13px;color:var(--mb-muted);white-space:nowrap}.mbsf-star,.mbsf-error{color:var(--mb-danger)}
-.mbsf-card{min-width:0;margin:0;padding:24px;border:1px solid var(--mb-border);border-radius:var(--mb-radius);background:var(--mb-surface);box-shadow:var(--mb-shadow)}.mbsf-card[data-invalid=true]{border-color:var(--mb-danger)}.mbsf-legend{padding:0 10px;font-size:18px;font-weight:760}.mbsf-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:18px 24px}.mbsf-span{grid-column:1/-1}.mbsf-field{display:grid;align-content:start;gap:7px;min-width:0}.mbsf-label{font-weight:680}.mbsf-input,.mbsf-select{width:100%;min-height:46px;padding:10px 12px;border:1px solid var(--mb-border);border-radius:var(--mb-control-radius);background:var(--mb-input);color:var(--mb-text);font:inherit}.mbsf-input:focus,.mbsf-select:focus{outline:3px solid color-mix(in srgb,var(--mb-accent) 22%,transparent);border-color:var(--mb-accent)}.mbsf-field[data-invalid=true] .mbsf-input,.mbsf-field[data-invalid=true] .mbsf-select,.mbsf-invalid-control .mbsf-input{border-color:var(--mb-danger);background:color-mix(in srgb,var(--mb-danger) 4%,var(--mb-input))}.mbsf-field[data-invalid=true] .mbsf-input:focus,.mbsf-field[data-invalid=true] .mbsf-select:focus{outline-color:color-mix(in srgb,var(--mb-danger) 24%,transparent)}
+.mbsf-card{min-width:0;margin:0;padding:24px;border:1px solid var(--mb-border);border-radius:var(--mb-radius);background:var(--mb-surface);box-shadow:var(--mb-shadow)}.mbsf-card[data-invalid=true]{border-color:var(--mb-danger)}.mbsf-legend{padding:0 10px;font-size:18px;font-weight:760}.mbsf-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:18px 24px}.mbsf-subhead{grid-column:1/-1;margin:6px 0 -2px;padding-top:14px;border-top:1px solid var(--mb-border);font-size:15px;font-weight:780;letter-spacing:.01em}.mbsf-subhead:first-child{margin-top:0;padding-top:0;border-top:0}.mbsf-span{grid-column:1/-1}.mbsf-field{display:grid;align-content:start;gap:7px;min-width:0}.mbsf-label{font-weight:680}.mbsf-input,.mbsf-select{width:100%;min-height:46px;padding:10px 12px;border:1px solid var(--mb-border);border-radius:var(--mb-control-radius);background:var(--mb-input);color:var(--mb-text);font:inherit}.mbsf-input:focus,.mbsf-select:focus{outline:3px solid color-mix(in srgb,var(--mb-accent) 22%,transparent);border-color:var(--mb-accent)}.mbsf-field[data-invalid=true] .mbsf-input,.mbsf-field[data-invalid=true] .mbsf-select,.mbsf-invalid-control .mbsf-input{border-color:var(--mb-danger);background:color-mix(in srgb,var(--mb-danger) 4%,var(--mb-input))}.mbsf-field[data-invalid=true] .mbsf-input:focus,.mbsf-field[data-invalid=true] .mbsf-select:focus{outline-color:color-mix(in srgb,var(--mb-danger) 24%,transparent)}
 .mbsf-combo{position:relative}.mbsf-menu{position:absolute;z-index:20;top:calc(100% + 5px);left:0;right:0;max-height:min(360px,46vh);overflow:auto;overscroll-behavior:contain;padding:7px;border:1px solid var(--mb-border);border-radius:12px;background:var(--mb-surface);box-shadow:0 14px 35px rgba(17,38,49,.16)}.mbsf-option{display:grid;width:100%;gap:2px;padding:10px;border:0;border-radius:8px;background:transparent;color:var(--mb-text);font:inherit;text-align:left;cursor:pointer}.mbsf-option:hover,.mbsf-option:focus{background:color-mix(in srgb,var(--mb-accent) 9%,var(--mb-surface))}.mbsf-option small{color:var(--mb-muted)}.mbsf-menu-status{padding:12px;text-align:center;color:var(--mb-muted);font-size:13px}
 .mbsf-payer-status{display:flex;align-items:center;gap:7px;color:#087f5b;font-size:13px;font-weight:650}.mbsf-payer-intro{margin:4px 0 0;color:var(--mb-muted)}.mbsf-payer-list{display:grid;gap:8px}.mbsf-payer-option{display:flex;align-items:center;justify-content:space-between;gap:14px;padding:11px 12px;border:1px solid var(--mb-border);border-radius:var(--mb-control-radius);background:color-mix(in srgb,var(--mb-accent) 3%,var(--mb-surface))}.mbsf-payer-option-main{display:grid;gap:5px;min-width:0}.mbsf-payer-option-main strong{overflow-wrap:anywhere}.mbsf-payer-signals{display:flex;flex-wrap:wrap;gap:6px}.mbsf-payer-signal{padding:2px 7px;border:1px solid var(--mb-border);border-radius:999px;color:var(--mb-muted);font-size:12px}.mbsf-payer-signal[data-state=match]{border-color:color-mix(in srgb,#159447 45%,var(--mb-border));color:#087f5b}.mbsf-payer-signal[data-state=warning]{border-color:color-mix(in srgb,#c56a00 55%,var(--mb-border));color:#9a5200}
 .mbsf-chips,.mbsf-quick-picks{display:flex;flex-wrap:wrap;gap:7px;margin-bottom:8px}.mbsf-chip,.mbsf-quick-pick{display:inline-flex;align-items:center;gap:7px;padding:5px 9px;border:1px solid var(--mb-border);border-radius:999px;background:var(--mb-input)}.mbsf-chip button{border:0;background:transparent;color:var(--mb-muted);cursor:pointer;font:inherit}.mbsf-quick-pick{color:var(--mb-text);font:inherit;cursor:pointer}.mbsf-quick-pick[data-selected=true]{border-color:var(--mb-accent);color:var(--mb-accent)}
@@ -1582,9 +1704,9 @@ function Field2({ label, required, error, path, span, children }) {
   ] });
 }
 function TextDateInput({ value, onChange, disabled, required, ariaLabel }) {
-  const [display, setDisplay] = useState2(() => formatBillSubmissionDate(value));
-  const [invalid, setInvalid] = useState2(false);
-  useEffect2(() => {
+  const [display, setDisplay] = useState3(() => formatBillSubmissionDate(value));
+  const [invalid, setInvalid] = useState3(false);
+  useEffect3(() => {
     setDisplay(formatBillSubmissionDate(value));
     setInvalid(false);
   }, [value]);
@@ -1601,8 +1723,8 @@ function TextDateInput({ value, onChange, disabled, required, ariaLabel }) {
   ] });
 }
 function ComboBox({ value, placeholder, options, disabled, loading, loadingMore, invalid, preserveValueOnOpen = false, onOpen, onQuery, onEndReached, onSelect, createOption, ariaLabel }) {
-  const [open, setOpen] = useState2(false);
-  const [query, setQuery] = useState2("");
+  const [open, setOpen] = useState3(false);
+  const [query, setQuery] = useState3("");
   const visible = useMemo2(() => {
     const q = query.trim().toLowerCase();
     const matches = q ? options.filter((option) => `${option.id} ${option.label} ${option.detail ?? ""}`.toLowerCase().includes(q)) : options;
@@ -1722,6 +1844,7 @@ function BillSubmissionForm({
   onLookupPostalCode,
   procedureOptions,
   modifierOptions,
+  taxonomyOptions,
   attachmentReportTypeMode = "auto",
   attachmentReportTypes = BILL_SUBMISSION_REPORT_TYPES,
   defaultAttachmentReportType,
@@ -1734,24 +1857,24 @@ function BillSubmissionForm({
   description = "Review the bill details, add attachments, and submit.",
   children
 }) {
-  const [bill, setBill] = useState2(() => cloneInitialBill(initialBill));
-  const [selectedIds, setSelectedIds] = useState2(() => attachments.map((item) => item.id));
-  const [removedSourceIds, setRemovedSourceIds] = useState2([]);
-  const [uploads, setUploads] = useState2([]);
-  const [errors, setErrors] = useState2({});
-  const [sourceAttachmentReportTypes, setSourceAttachmentReportTypes] = useState2(() => Object.fromEntries(attachments.flatMap((item) => item.reportTypeCode ? [[item.id, item.reportTypeCode]] : [])));
-  const [validationActive, setValidationActive] = useState2(false);
-  const [formError, setFormError] = useState2(null);
-  const [submitting, setSubmitting] = useState2(false);
-  const [payerResults, setPayerResults] = useState2([]);
-  const [payerLoading, setPayerLoading] = useState2(false);
-  const [diagnosisResults, setDiagnosisResults] = useState2([]);
-  const [diagnosisLoading, setDiagnosisLoading] = useState2(false);
-  const [diagnosisLoadingMore, setDiagnosisLoadingMore] = useState2(false);
-  const [diagnosisQuery, setDiagnosisQuery] = useState2(null);
-  const [diagnosisHasMore, setDiagnosisHasMore] = useState2(true);
-  const [postalStatus, setPostalStatus] = useState2(null);
-  const [dragActive, setDragActive] = useState2(false);
+  const [bill, setBill] = useState3(() => cloneInitialBill(initialBill));
+  const [selectedIds, setSelectedIds] = useState3(() => attachments.map((item) => item.id));
+  const [removedSourceIds, setRemovedSourceIds] = useState3([]);
+  const [uploads, setUploads] = useState3([]);
+  const [errors, setErrors] = useState3({});
+  const [sourceAttachmentReportTypes, setSourceAttachmentReportTypes] = useState3(() => Object.fromEntries(attachments.flatMap((item) => item.reportTypeCode ? [[item.id, item.reportTypeCode]] : [])));
+  const [validationActive, setValidationActive] = useState3(false);
+  const [formError, setFormError] = useState3(null);
+  const [submitting, setSubmitting] = useState3(false);
+  const [payerResults, setPayerResults] = useState3([]);
+  const [payerLoading, setPayerLoading] = useState3(false);
+  const [diagnosisResults, setDiagnosisResults] = useState3([]);
+  const [diagnosisLoading, setDiagnosisLoading] = useState3(false);
+  const [diagnosisLoadingMore, setDiagnosisLoadingMore] = useState3(false);
+  const [diagnosisQuery, setDiagnosisQuery] = useState3(null);
+  const [diagnosisHasMore, setDiagnosisHasMore] = useState3(true);
+  const [postalStatus, setPostalStatus] = useState3(null);
+  const [dragActive, setDragActive] = useState3(false);
   const formRef = useRef2(null);
   const fileInput = useRef2(null);
   const diagnosisRequest = useRef2(0);
@@ -1759,7 +1882,8 @@ function BillSubmissionForm({
   const payerRequest = useRef2(0);
   const procedures = useMemo2(() => mergeOptions(DEFAULT_BILL_SUBMISSION_PROCEDURES, procedureOptions), [procedureOptions]);
   const modifiers = useMemo2(() => mergeOptions(DEFAULT_BILL_SUBMISSION_MODIFIERS, modifierOptions), [modifierOptions]);
-  const [evaluationType, setEvaluationType] = useState2(() => initialEvaluationType(initialBill));
+  const taxonomies = useMemo2(() => mergeOptions(DEFAULT_BILL_SUBMISSION_TAXONOMIES, taxonomyOptions), [taxonomyOptions]);
+  const [evaluationType, setEvaluationType] = useState3(() => initialEvaluationType(initialBill));
   const connected = !onSubmit;
   const referenceClient = useMemo2(() => getSession || sessionEndpoint || connected ? createBillReferenceClient({ getSession, sessionEndpoint, apiBaseUrl, fetch: fetchOverride }) : null, [getSession, sessionEndpoint, apiBaseUrl, fetchOverride, connected]);
   const submissionClient = useMemo2(() => connected ? createBillSubmissionClient({ getSession, sessionEndpoint, apiBaseUrl, fetch: fetchOverride }) : null, [getSession, sessionEndpoint, apiBaseUrl, fetchOverride, connected]);
@@ -1768,7 +1892,7 @@ function BillSubmissionForm({
   const forcedAttachmentReportType = showAttachmentReportTypes ? void 0 : defaultAttachmentReportType ?? MED_LEGAL_REPORT_TYPE_CODE;
   const reportTypeOptions = useMemo2(() => attachmentReportTypes.map((item) => ({ id: item.code, label: item.code.replace(/^OZ:/, ""), detail: item.label })), [attachmentReportTypes]);
   const missingAttachmentReportType = showAttachmentReportTypes && (selectedIds.some((id) => !(sourceAttachmentReportTypes[id] || attachments.find((item) => item.id === id)?.reportTypeCode || defaultAttachmentReportType)) || uploads.some((upload) => !(upload.reportTypeCode || defaultAttachmentReportType)));
-  useEffect2(() => {
+  useEffect3(() => {
     setBill(cloneInitialBill(initialBill));
     setEvaluationType(initialEvaluationType(initialBill));
     setSelectedIds(attachments.map((item) => item.id));
@@ -1784,7 +1908,7 @@ function BillSubmissionForm({
     diagnosisRequest.current += 1;
     diagnosisAppendPending.current = false;
   }, [initialBill, attachments]);
-  useEffect2(() => {
+  useEffect3(() => {
     if (!validationActive) return;
     const next = validateBillSubmission(bill).fieldErrors;
     setErrors(missingAttachmentReportType ? { ...next, attachments: "Select a report type for every attachment." } : next);
@@ -1802,7 +1926,7 @@ function BillSubmissionForm({
     if (selectedIds.length + uploads.length + files.length > MAX_DOCUMENTS) return setFormError(`A bill can include at most ${MAX_DOCUMENTS} attachments.`);
     setUploads((current) => [...current, ...files.map((file) => ({ file, documentType: "other", ...defaultAttachmentReportType ? { reportTypeCode: defaultAttachmentReportType } : {} }))]);
   }, [defaultAttachmentReportType, selectedIds.length, uploads]);
-  useEffect2(() => {
+  useEffect3(() => {
     const over = (event) => {
       if (event.dataTransfer?.types.includes("Files")) {
         event.preventDefault();
@@ -1872,7 +1996,7 @@ function BillSubmissionForm({
     });
     void runPayerSearch(query, true);
   };
-  useEffect2(() => {
+  useEffect3(() => {
     const payer = bill.claim.claimsAdministrator;
     if (!payer?.name || payer.name.trim().length < 2) return;
     void runPayerSearch(payer.name, !payer.id);
@@ -1952,10 +2076,11 @@ function BillSubmissionForm({
       return;
     }
     if (selectedIds.length + uploads.length > MAX_DOCUMENTS) return setFormError(`A bill can include at most ${MAX_DOCUMENTS} attachments.`);
+    const complete = clean;
     setSubmitting(true);
     try {
       if (onSubmit) {
-        await onSubmit({ bill: clean, sourceAttachmentIds: selectedIds, sourceAttachmentReportTypes, uploads });
+        await onSubmit({ bill: complete, sourceAttachmentIds: selectedIds, sourceAttachmentReportTypes, uploads });
       } else {
         if (!submissionClient) throw new Error("The connected billing client is unavailable.");
         const documents = await prepareBillSubmissionDocuments({
@@ -1966,7 +2091,7 @@ function BillSubmissionForm({
           ...forcedAttachmentReportType ? { defaultReportTypeCode: forcedAttachmentReportType } : {},
           ...fetchOverride ? { fetch: fetchOverride } : {}
         });
-        const result = await submissionClient.submitBill({ bill: clean, documents });
+        const result = await submissionClient.submitBill({ bill: complete, documents });
         await onSubmitted?.(result);
       }
     } catch (caught) {
@@ -2010,8 +2135,8 @@ function BillSubmissionForm({
     /* @__PURE__ */ jsx3("legend", { className: "mbsf-legend", children: "Injury & claim" }),
     /* @__PURE__ */ jsxs3("div", { className: "mbsf-grid", children: [
       /* @__PURE__ */ jsx3(Field2, { path: "service.date", label: "Date of service", required: true, error: errors["service.date"], children: /* @__PURE__ */ jsx3(TextDateInput, { ariaLabel: "Date of service", value: bill.service.date, disabled: locked, required: true, onChange: (date2) => setBill((c) => ({ ...c, service: { ...c.service, date: date2 } })) }) }),
-      /* @__PURE__ */ jsx3(Field2, { label: "Date of injury", children: /* @__PURE__ */ jsx3(TextDateInput, { ariaLabel: "Date of injury", value: bill.claim.dateOfInjury, disabled: locked, onChange: (dateOfInjury) => setBill((c) => ({ ...c, claim: { ...c.claim, dateOfInjury } })) }) }),
-      /* @__PURE__ */ jsx3(Field2, { label: "Employer (optional)", children: text(bill.claim.employer, (employer) => setBill((c) => ({ ...c, claim: { ...c.claim, employer } }))) }),
+      /* @__PURE__ */ jsx3(Field2, { path: "claim.dateOfInjury", label: "Date of injury", required: true, error: errors["claim.dateOfInjury"], children: /* @__PURE__ */ jsx3(TextDateInput, { ariaLabel: "Date of injury", value: bill.claim.dateOfInjury, disabled: locked, required: true, onChange: (dateOfInjury) => setBill((c) => ({ ...c, claim: { ...c.claim, dateOfInjury } })) }) }),
+      /* @__PURE__ */ jsx3(Field2, { path: "claim.employer", label: "Employer name", required: true, error: errors["claim.employer"], children: text(bill.claim.employer, (employer) => setBill((c) => ({ ...c, claim: { ...c.claim, employer } }))) }),
       /* @__PURE__ */ jsx3(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__ */ jsx3(Field2, { label: "WCAB / ADJ number (optional)", children: text(bill.claim.adjNumber, (adjNumber) => setBill((c) => ({ ...c, claim: { ...c.claim, adjNumber } }))) }),
       /* @__PURE__ */ jsxs3(Field2, { path: "claim.claimsAdministrator", label: "Claims administrator", required: true, span: true, error: claimsAdministratorError, children: [
@@ -2073,17 +2198,33 @@ function BillSubmissionForm({
   const providersSection = /* @__PURE__ */ jsxs3("fieldset", { className: "mbsf-card", disabled: locked, children: [
     /* @__PURE__ */ jsx3("legend", { className: "mbsf-legend", children: "Providers & place of service" }),
     /* @__PURE__ */ jsxs3("div", { className: "mbsf-grid", children: [
-      /* @__PURE__ */ jsx3(Field2, { label: "Billing provider", children: text(bill.billingProvider?.name, (name) => setBill((c) => ({ ...c, billingProvider: { ...c.billingProvider, name } }))) }),
-      /* @__PURE__ */ jsx3(Field2, { label: "Billing tax ID", children: text(bill.billingProvider?.taxId, (taxId) => setBill((c) => ({ ...c, billingProvider: { ...c.billingProvider, taxId } }))) }),
-      /* @__PURE__ */ jsx3(Field2, { label: "Billing NPI", children: text(bill.billingProvider?.npi, (npi) => setBill((c) => ({ ...c, billingProvider: { ...c.billingProvider, npi } }))) }),
-      /* @__PURE__ */ jsx3(Field2, { label: "Billing phone", children: text(bill.billingProvider?.phone, (phone) => setBill((c) => ({ ...c, billingProvider: { ...c.billingProvider, phone } })), { type: "tel" }) }),
-      /* @__PURE__ */ jsx3(Field2, { label: "Rendering provider", children: text(bill.renderingProvider?.name, (name) => setBill((c) => ({ ...c, renderingProvider: { ...c.renderingProvider, name } }))) }),
-      /* @__PURE__ */ jsx3(Field2, { label: "Specialty", children: text(bill.renderingProvider?.specialty, (specialty) => setBill((c) => ({ ...c, renderingProvider: { ...c.renderingProvider, specialty } }))) }),
-      /* @__PURE__ */ jsx3(Field2, { label: "Rendering NPI", children: text(bill.renderingProvider?.npi, (npi) => setBill((c) => ({ ...c, renderingProvider: { ...c.renderingProvider, npi } }))) }),
-      /* @__PURE__ */ jsx3(Field2, { label: "License number", children: text(bill.renderingProvider?.licenseNumber, (licenseNumber) => setBill((c) => ({ ...c, renderingProvider: { ...c.renderingProvider, licenseNumber } }))) }),
-      /* @__PURE__ */ jsx3(Field2, { label: "License state", children: text(bill.renderingProvider?.licenseState, (licenseState) => setBill((c) => ({ ...c, renderingProvider: { ...c.renderingProvider, licenseState: licenseState.toUpperCase() } })), { maxLength: 2 }) }),
-      /* @__PURE__ */ jsx3(Field2, { label: "Service location", children: text(bill.serviceLocation?.name, (name) => setBill((c) => ({ ...c, serviceLocation: { ...c.serviceLocation, name } }))) }),
-      /* @__PURE__ */ jsx3(Field2, { label: "Place of service", children: text(bill.serviceLocation?.placeOfServiceCode, (placeOfServiceCode) => setBill((c) => ({ ...c, serviceLocation: { ...c.serviceLocation, placeOfServiceCode } })), { maxLength: 2 }) })
+      /* @__PURE__ */ jsx3("h4", { className: "mbsf-subhead", children: "Billing provider" }),
+      /* @__PURE__ */ jsx3(Field2, { path: "billingProvider.name", label: "Billing provider name", required: true, error: errors["billingProvider.name"], children: text(bill.billingProvider?.name, (name) => setBill((c) => ({ ...c, billingProvider: { ...c.billingProvider, name } }))) }),
+      /* @__PURE__ */ jsx3(Field2, { path: "billingProvider.taxId", label: "Tax ID (EIN / SSN)", required: true, error: errors["billingProvider.taxId"], children: text(bill.billingProvider?.taxId, (taxId) => setBill((c) => ({ ...c, billingProvider: { ...c.billingProvider, taxId } })), { inputMode: "numeric" }) }),
+      /* @__PURE__ */ jsx3(Field2, { path: "billingProvider.npi", label: "Billing provider NPI", required: true, error: errors["billingProvider.npi"], children: text(bill.billingProvider?.npi, (npi) => setBill((c) => ({ ...c, billingProvider: { ...c.billingProvider, npi } })), { inputMode: "numeric", maxLength: 10 }) }),
+      /* @__PURE__ */ jsx3(Field2, { path: "billingProvider.phone", label: "Billing provider phone", required: true, error: errors["billingProvider.phone"], children: text(bill.billingProvider?.phone, (phone) => setBill((c) => ({ ...c, billingProvider: { ...c.billingProvider, phone } })), { type: "tel" }) }),
+      /* @__PURE__ */ jsx3(Field2, { path: "billingProvider.address.line1", label: "Billing address line 1", required: true, span: true, error: errors["billingProvider.address.line1"], children: text(bill.billingProvider?.address?.line1, (line1) => setBill((c) => ({ ...c, billingProvider: { ...c.billingProvider, address: { line1, line2: c.billingProvider?.address?.line2 ?? "", city: c.billingProvider?.address?.city ?? "", state: c.billingProvider?.address?.state ?? "", postalCode: c.billingProvider?.address?.postalCode ?? "" } } }))) }),
+      /* @__PURE__ */ jsx3(Field2, { label: "Billing address line 2 (optional)", span: true, children: text(bill.billingProvider?.address?.line2, (line2) => setBill((c) => ({ ...c, billingProvider: { ...c.billingProvider, address: { line1: c.billingProvider?.address?.line1 ?? "", line2, city: c.billingProvider?.address?.city ?? "", state: c.billingProvider?.address?.state ?? "", postalCode: c.billingProvider?.address?.postalCode ?? "" } } }))) }),
+      /* @__PURE__ */ jsx3(Field2, { path: "billingProvider.address.city", label: "Billing city", required: true, error: errors["billingProvider.address.city"], children: text(bill.billingProvider?.address?.city, (city) => setBill((c) => ({ ...c, billingProvider: { ...c.billingProvider, address: { line1: c.billingProvider?.address?.line1 ?? "", line2: c.billingProvider?.address?.line2 ?? "", city, state: c.billingProvider?.address?.state ?? "", postalCode: c.billingProvider?.address?.postalCode ?? "" } } }))) }),
+      /* @__PURE__ */ jsx3(Field2, { path: "billingProvider.address.state", label: "Billing state", required: true, error: errors["billingProvider.address.state"], children: text(bill.billingProvider?.address?.state, (state) => setBill((c) => ({ ...c, billingProvider: { ...c.billingProvider, address: { line1: c.billingProvider?.address?.line1 ?? "", line2: c.billingProvider?.address?.line2 ?? "", city: c.billingProvider?.address?.city ?? "", state: state.toUpperCase(), postalCode: c.billingProvider?.address?.postalCode ?? "" } } })), { maxLength: 2 }) }),
+      /* @__PURE__ */ jsx3(Field2, { path: "billingProvider.address.postalCode", label: "Billing ZIP", required: true, error: errors["billingProvider.address.postalCode"], children: text(bill.billingProvider?.address?.postalCode, (postalCode) => setBill((c) => ({ ...c, billingProvider: { ...c.billingProvider, address: { line1: c.billingProvider?.address?.line1 ?? "", line2: c.billingProvider?.address?.line2 ?? "", city: c.billingProvider?.address?.city ?? "", state: c.billingProvider?.address?.state ?? "", postalCode } } }))) }),
+      /* @__PURE__ */ jsx3("h4", { className: "mbsf-subhead", children: "Rendering provider" }),
+      /* @__PURE__ */ jsx3(Field2, { path: "renderingProvider.name", label: "Rendering provider name", required: true, error: errors["renderingProvider.name"], children: text(bill.renderingProvider?.name, (name) => setBill((c) => ({ ...c, renderingProvider: { ...c.renderingProvider, name } }))) }),
+      /* @__PURE__ */ jsx3(Field2, { path: "renderingProvider.npi", label: "Rendering provider NPI", required: true, error: errors["renderingProvider.npi"], children: text(bill.renderingProvider?.npi, (npi) => setBill((c) => ({ ...c, renderingProvider: { ...c.renderingProvider, npi } })), { inputMode: "numeric", maxLength: 10 }) }),
+      /* @__PURE__ */ jsxs3(Field2, { path: "renderingProvider.taxonomy", label: "Rendering taxonomy", required: true, error: errors["renderingProvider.taxonomy"], children: [
+        /* @__PURE__ */ jsx3(ComboBox, { ariaLabel: "Rendering taxonomy", invalid: Boolean(errors["renderingProvider.taxonomy"]), disabled: locked, preserveValueOnOpen: true, value: bill.renderingProvider?.taxonomy ?? "", placeholder: "Search specialty name or taxonomy code\u2026", options: taxonomies.map((item) => ({ id: item.code, label: item.description, detail: item.code })), createOption: (query) => {
+          const code = query.trim().toUpperCase();
+          return /^[A-Z0-9]{10}$/.test(code) ? { id: code, label: code, detail: "Use this taxonomy code" } : null;
+        }, onSelect: (option) => setBill((c) => ({ ...c, renderingProvider: { ...c.renderingProvider, taxonomy: option.id } })) }),
+        /* @__PURE__ */ jsx3("small", { className: "mbsf-help", children: "Search by specialty name or 10-character taxonomy code." })
+      ] }),
+      /* @__PURE__ */ jsx3("h4", { className: "mbsf-subhead", children: "Service facility" }),
+      /* @__PURE__ */ jsx3(Field2, { path: "serviceLocation.placeOfServiceCode", label: "Place of service code", required: true, error: errors["serviceLocation.placeOfServiceCode"], children: text(bill.serviceLocation?.placeOfServiceCode, (placeOfServiceCode) => setBill((c) => ({ ...c, serviceLocation: { ...c.serviceLocation, placeOfServiceCode } })), { inputMode: "numeric", maxLength: 2, placeholder: "11" }) }),
+      /* @__PURE__ */ jsx3(Field2, { path: "serviceLocation.address.line1", label: "Service address line 1", required: true, span: true, error: errors["serviceLocation.address.line1"], children: text(bill.serviceLocation?.address?.line1, (line1) => setBill((c) => ({ ...c, serviceLocation: { ...c.serviceLocation, address: { line1, line2: c.serviceLocation?.address?.line2 ?? "", city: c.serviceLocation?.address?.city ?? "", state: c.serviceLocation?.address?.state ?? "", postalCode: c.serviceLocation?.address?.postalCode ?? "" } } }))) }),
+      /* @__PURE__ */ jsx3(Field2, { label: "Service address line 2 (optional)", span: true, children: text(bill.serviceLocation?.address?.line2, (line2) => setBill((c) => ({ ...c, serviceLocation: { ...c.serviceLocation, address: { line1: c.serviceLocation?.address?.line1 ?? "", line2, city: c.serviceLocation?.address?.city ?? "", state: c.serviceLocation?.address?.state ?? "", postalCode: c.serviceLocation?.address?.postalCode ?? "" } } }))) }),
+      /* @__PURE__ */ jsx3(Field2, { path: "serviceLocation.address.city", label: "Service city", required: true, error: errors["serviceLocation.address.city"], children: text(bill.serviceLocation?.address?.city, (city) => setBill((c) => ({ ...c, serviceLocation: { ...c.serviceLocation, address: { line1: c.serviceLocation?.address?.line1 ?? "", line2: c.serviceLocation?.address?.line2 ?? "", city, state: c.serviceLocation?.address?.state ?? "", postalCode: c.serviceLocation?.address?.postalCode ?? "" } } }))) }),
+      /* @__PURE__ */ jsx3(Field2, { path: "serviceLocation.address.state", label: "Service state", required: true, error: errors["serviceLocation.address.state"], children: text(bill.serviceLocation?.address?.state, (state) => setBill((c) => ({ ...c, serviceLocation: { ...c.serviceLocation, address: { line1: c.serviceLocation?.address?.line1 ?? "", line2: c.serviceLocation?.address?.line2 ?? "", city: c.serviceLocation?.address?.city ?? "", state: state.toUpperCase(), postalCode: c.serviceLocation?.address?.postalCode ?? "" } } })), { maxLength: 2 }) }),
+      /* @__PURE__ */ jsx3(Field2, { path: "serviceLocation.address.postalCode", label: "Service ZIP", required: true, error: errors["serviceLocation.address.postalCode"], children: text(bill.serviceLocation?.address?.postalCode, (postalCode) => setBill((c) => ({ ...c, serviceLocation: { ...c.serviceLocation, address: { line1: c.serviceLocation?.address?.line1 ?? "", line2: c.serviceLocation?.address?.line2 ?? "", city: c.serviceLocation?.address?.city ?? "", state: c.serviceLocation?.address?.state ?? "", postalCode } } }))) })
     ] })
   ] });
   const serviceLinesSection = /* @__PURE__ */ jsxs3("fieldset", { className: "mbsf-card", disabled: locked, children: [
@@ -2093,9 +2234,15 @@ function BillSubmissionForm({
     /* @__PURE__ */ jsx3("p", { className: "mbsf-help", children: evaluationType === "ame" ? "Agreed Medical Evaluator \u2014 eligible ML evaluation codes default to modifier -94." : evaluationType === "psych_qme" ? "Psychiatric QME \u2014 eligible ML evaluation codes default to modifier -96 (-95 for ML200)." : "Qualified Medical Evaluator \u2014 eligible ML evaluation codes default to modifier -95." }),
     /* @__PURE__ */ jsxs3("div", { className: "mbsf-lines", "data-field-path": "serviceLines", "data-invalid": Boolean(errors.serviceLines), children: [
       /* @__PURE__ */ jsxs3("div", { className: "mbsf-line-head", children: [
-        /* @__PURE__ */ jsx3("span", { children: "Procedure code" }),
+        /* @__PURE__ */ jsxs3("span", { children: [
+          "Procedure code",
+          /* @__PURE__ */ jsx3(RequiredMark, {})
+        ] }),
         /* @__PURE__ */ jsx3("span", { children: "Modifiers" }),
-        /* @__PURE__ */ jsx3("span", { children: "Units" }),
+        /* @__PURE__ */ jsxs3("span", { children: [
+          "Units",
+          /* @__PURE__ */ jsx3(RequiredMark, {})
+        ] }),
         /* @__PURE__ */ jsx3("span", { children: "Allowed" }),
         /* @__PURE__ */ jsx3("span", {}),
         " "
@@ -2217,7 +2364,7 @@ function BillSubmissionForm({
 }
 
 // src/billing-dashboard.tsx
-import { useMemo as useMemo3, useState as useState3 } from "react";
+import { useMemo as useMemo3, useState as useState4 } from "react";
 import { Fragment as Fragment3, jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
 var css2 = `
 .mbdash{display:grid;gap:20px;color:var(--mb-text);font-family:var(--mb-font);font-size:15px}.mbdash *{box-sizing:border-box}.mbdash h2,.mbdash h3,.mbdash p{margin:0}.mbdash-copy{color:var(--mb-muted);margin-top:5px!important}.mbdash-card{min-width:0;border:1px solid var(--mb-border);border-radius:var(--mb-radius);background:var(--mb-surface);box-shadow:var(--mb-shadow)}
@@ -2385,8 +2532,8 @@ function BillAgingSummary(props) {
   return /* @__PURE__ */ jsx4(Shell, { ...shellProps, children: /* @__PURE__ */ jsx4(AgingContent, { bills: props.bills, ...props.heading === void 0 ? {} : { heading: props.heading } }) });
 }
 function BillingDashboard({ bills, heading = "Billing", description = "Track submitted bills, payments, and outstanding balances.", onSelectBill, initialSearch = "", initialState = "all", hideFilters = false, appearance, className, style }) {
-  const [search, setSearch] = useState3(initialSearch);
-  const [state, setState] = useState3(initialState);
+  const [search, setSearch] = useState4(initialSearch);
+  const [state, setState] = useState4(initialState);
   const states = useMemo3(() => [...new Set(bills.map((bill) => bill.state))].sort((a, b) => a.localeCompare(b)), [bills]);
   const filtered = useMemo3(() => {
     const query = search.trim().toLowerCase();
@@ -2482,10 +2629,10 @@ function BillingReport({ bills, groupBy = "status", heading = "Billing report",
 // src/connected-bill-status.tsx
 import {
   useCallback as useCallback2,
-  useEffect as useEffect3,
+  useEffect as useEffect4,
   useMemo as useMemo4,
   useRef as useRef3,
-  useState as useState4
+  useState as useState5
 } from "react";
 import {
   DEFAULT_API_BASE_URL,
@@ -2631,16 +2778,16 @@ function useBillStatus({
     apiBaseUrl,
     ...fetchOverride ? { fetch: fetchOverride } : {}
   }), [apiBaseUrl, billId, fetchOverride, getSession, sessionEndpoint]);
-  const [data, setData] = useState4(initialData);
-  const [error, setError] = useState4(null);
-  const [isLoading, setIsLoading] = useState4(enabled && !initialData);
-  const [isRefreshing, setIsRefreshing] = useState4(false);
+  const [data, setData] = useState5(initialData);
+  const [error, setError] = useState5(null);
+  const [isLoading, setIsLoading] = useState5(enabled && !initialData);
+  const [isRefreshing, setIsRefreshing] = useState5(false);
   const dataRef = useRef3(initialData);
   const initialDataRef = useRef3(initialData);
   initialDataRef.current = initialData;
   const activeControllerRef = useRef3(null);
   const requestSequence = useRef3(0);
-  useEffect3(() => {
+  useEffect4(() => {
     const seed = initialDataRef.current;
     dataRef.current = seed;
     setData(seed);
@@ -2681,10 +2828,10 @@ function useBillStatus({
       }
     }
   }, [billId, client, enabled]);
-  useEffect3(() => {
+  useEffect4(() => {
     if (enabled) void load();
   }, [enabled, load]);
-  useEffect3(() => {
+  useEffect4(() => {
     if (!enabled || refreshInterval <= 0) return;
     const timer = window.setInterval(() => void load(), refreshInterval);
     const onFocus = () => void load();
@@ -2792,13 +2939,10 @@ function defaultFormatDate(createdAt) {
 function BillActivityTimeline({ events, emptyLabel = "No bill activity yet.", appearance, className, style, formatDate = defaultFormatDate }) {
   return /* @__PURE__ */ jsxs6("section", { className: classes("mb-surface mb-activity", className), style: mindBillAppearanceStyle(appearance, style), "aria-label": "Bill activity", children: [
     /* @__PURE__ */ jsx6("style", { children: lifecycleSurfaceStyles }),
-    /* @__PURE__ */ jsxs6("header", { className: "mb-surface-heading", children: [
-      /* @__PURE__ */ jsxs6("div", { children: [
-        /* @__PURE__ */ jsx6("strong", { children: "Bill history" }),
-        /* @__PURE__ */ jsx6("span", { children: "Submission, payer responses, follow-up, and payments." })
-      ] }),
-      /* @__PURE__ */ jsx6("span", { children: events.length })
-    ] }),
+    /* @__PURE__ */ jsx6("header", { className: "mb-surface-heading", children: /* @__PURE__ */ jsxs6("div", { children: [
+      /* @__PURE__ */ jsx6("strong", { children: "Bill history" }),
+      /* @__PURE__ */ jsx6("span", { children: "Submission, payer responses, follow-up, and payments." })
+    ] }) }),
     !events.length ? /* @__PURE__ */ jsx6("p", { className: "mb-activity-empty", children: emptyLabel }) : /* @__PURE__ */ jsx6("ol", { className: "mb-activity-list", children: events.map((event) => /* @__PURE__ */ jsxs6("li", { className: "mb-activity-item", children: [
       /* @__PURE__ */ jsx6("span", { className: "mb-activity-marker", "aria-hidden": "true" }),
       /* @__PURE__ */ jsxs6("div", { className: "mb-activity-content", children: [
@@ -2976,16 +3120,16 @@ var lifecycleSurfaceStyles = `
 .mb-progress-list{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));list-style:none;margin:0;padding:0}.mb-progress-list li{display:grid;gap:7px;position:relative;text-align:center;color:var(--mb-muted);font-size:12px}.mb-progress-list li:not(:last-child)::after{content:"";position:absolute;left:calc(50% + 14px);right:calc(-50% + 14px);top:13px;height:2px;background:var(--mb-border)}.mb-progress-list li.is-complete:not(:last-child)::after{background:var(--mb-accent)}.mb-progress-list li>span{display:grid;place-items:center;justify-self:center;position:relative;z-index:1;width:28px;height:28px;border:2px solid var(--mb-border);border-radius:50%;background:var(--mb-surface);font-weight:800}.mb-progress-list li.is-complete>span,.mb-progress-list li.is-current>span{border-color:var(--mb-accent);background:var(--mb-accent);color:var(--mb-accent-contrast)}.mb-progress-list li.is-current{color:var(--mb-text)}
 .mb-snapshot dl,.mb-remittance dl,.mb-contacts dl{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:0;margin:0}.mb-snapshot dl>div,.mb-remittance dl>div,.mb-contacts dl>div{display:grid;gap:3px;padding:10px 14px;border-left:1px solid var(--mb-border)}.mb-snapshot dl>div:nth-child(3n+1),.mb-remittance dl>div:first-child,.mb-contacts dl>div:first-child{border-left:0}.mb-snapshot dt,.mb-remittance dt,.mb-contacts dt{color:var(--mb-muted);font-size:11px;font-weight:800;letter-spacing:.08em;text-transform:uppercase}.mb-snapshot dd,.mb-remittance dd,.mb-contacts dd{font-size:14px;font-weight:750;margin:0;overflow-wrap:anywhere}.mb-contacts a{color:var(--mb-accent)}.mb-denial{margin-top:16px;border-left:4px solid var(--mb-danger);border-radius:var(--mb-control-radius);background:color-mix(in srgb,var(--mb-danger) 8%,var(--mb-surface));padding:12px 14px}.mb-denial p{margin:4px 0 0}
 .mb-payment-list{display:grid}.mb-payment-list article{display:grid;grid-template-columns:1fr auto;gap:5px 18px;padding:12px 0;border-top:1px solid var(--mb-border)}.mb-payment-list article:first-child{border-top:0}.mb-payment-list article>div{display:grid;gap:2px}.mb-payment-list article>div:nth-child(2){text-align:right}.mb-payment-list article span{color:var(--mb-muted);font-size:12px}.mb-payment-list article p{grid-column:1/-1;margin:0;color:var(--mb-muted);font-size:13px}
-@media(max-width:700px){.mb-progress-list{grid-template-columns:1fr;text-align:left}.mb-progress-list li{grid-template-columns:28px 1fr;align-items:center;text-align:left}.mb-progress-list li:not(:last-child)::after{left:13px;right:auto;top:28px;bottom:-7px;width:2px;height:auto}.mb-progress-list li>span{grid-row:1}.mb-snapshot dl,.mb-remittance dl,.mb-contacts dl{grid-template-columns:1fr 1fr}.mb-snapshot dl>div,.mb-remittance dl>div,.mb-contacts dl>div{border:0;border-top:1px solid var(--mb-border);padding:10px 0}.mb-snapshot dl>div:nth-child(-n+2),.mb-remittance dl>div:nth-child(-n+2),.mb-contacts dl>div:nth-child(-n+2){border-top:0}.mb-payment-list article{grid-template-columns:1fr}.mb-payment-list article>div:nth-child(2){text-align:left}}
+@media(max-width:700px){.mb-surface.mb-progress{padding:16px 10px}.mb-progress-list{grid-template-columns:repeat(4,minmax(0,1fr))}.mb-progress-list li{display:grid;grid-template-columns:1fr;align-items:start;gap:6px;text-align:center;font-size:10px;min-width:0}.mb-progress-list li b{font-size:10px;white-space:nowrap}.mb-progress-list li:not(:last-child)::after{left:calc(50% + 12px);right:calc(-50% + 12px);top:11px;bottom:auto;width:auto;height:2px}.mb-progress-list li>span{grid-row:auto;width:24px;height:24px;font-size:11px}.mb-snapshot dl,.mb-remittance dl,.mb-contacts dl{grid-template-columns:1fr 1fr}.mb-snapshot dl>div,.mb-remittance dl>div,.mb-contacts dl>div{border:0;border-top:1px solid var(--mb-border);padding:10px 0}.mb-snapshot dl>div:nth-child(-n+2),.mb-remittance dl>div:nth-child(-n+2),.mb-contacts dl>div:nth-child(-n+2){border-top:0}.mb-payment-list article{grid-template-columns:1fr}.mb-payment-list article>div:nth-child(2){text-align:left}}
 `;
 
 // src/connected-bill-lifecycle.tsx
 import {
   useCallback as useCallback3,
-  useEffect as useEffect4,
+  useEffect as useEffect5,
   useMemo as useMemo5,
   useRef as useRef4,
-  useState as useState5
+  useState as useState6
 } from "react";
 import {
   DEFAULT_API_BASE_URL as DEFAULT_API_BASE_URL2,
@@ -2995,16 +3139,32 @@ import {
 import { createBillLifecycleClient as createBillLifecycleClient2 } from "@mindbill/browser";
 import { Fragment as Fragment5, jsx as jsx7, jsxs as jsxs7 } from "react/jsx-runtime";
 var DEFAULT_REFRESH_INTERVAL2 = 6e4;
-function downloadBlob(blob, filename, open = false) {
+function downloadBlob(blob, filename) {
   const url = URL.createObjectURL(blob);
   const link = document.createElement("a");
   link.href = url;
   link.rel = "noopener noreferrer";
   link.download = filename;
-  if (open) link.target = "_blank";
   link.click();
   window.setTimeout(() => URL.revokeObjectURL(url), 6e4);
 }
+function reservePreviewWindow() {
+  const preview = window.open("about:blank", "_blank");
+  if (preview) preview.opener = null;
+  return preview;
+}
+function previewBlob(blob, preview) {
+  const url = URL.createObjectURL(blob);
+  if (preview) preview.location.replace(url);
+  else {
+    const link = document.createElement("a");
+    link.href = url;
+    link.target = "_blank";
+    link.rel = "noopener noreferrer";
+    link.click();
+  }
+  window.setTimeout(() => URL.revokeObjectURL(url), 3e5);
+}
 function useBillLifecycle({
   billId: providedBillId,
   sessionEndpoint = DEFAULT_SESSION_ENDPOINT2,
@@ -3015,11 +3175,11 @@ function useBillLifecycle({
   initialData = null,
   fetch: fetchOverride
 }) {
-  const [data, setData] = useState5(initialData);
-  const [error, setError] = useState5(null);
-  const [isLoading, setIsLoading] = useState5(enabled && !initialData);
-  const [isRefreshing, setIsRefreshing] = useState5(false);
-  const [isMutating, setIsMutating] = useState5(false);
+  const [data, setData] = useState6(initialData);
+  const [error, setError] = useState6(null);
+  const [isLoading, setIsLoading] = useState6(enabled && !initialData);
+  const [isRefreshing, setIsRefreshing] = useState6(false);
+  const [isMutating, setIsMutating] = useState6(false);
   const mounted = useRef4(true);
   const client = useMemo5(() => createBillLifecycleClient({
     billId: providedBillId,
@@ -3028,11 +3188,11 @@ function useBillLifecycle({
     apiBaseUrl,
     fetch: fetchOverride
   }), [apiBaseUrl, fetchOverride, getSession, providedBillId, sessionEndpoint]);
-  useEffect4(() => {
+  useEffect5(() => {
     setData(initialData);
     setError(null);
   }, [initialData, providedBillId]);
-  useEffect4(() => {
+  useEffect5(() => {
     mounted.current = true;
     return () => {
       mounted.current = false;
@@ -3056,7 +3216,7 @@ function useBillLifecycle({
       }
     }
   }, [client, enabled]);
-  useEffect4(() => {
+  useEffect5(() => {
     if (!enabled) return;
     void refresh();
     const interval = refreshInterval > 0 ? window.setInterval(() => void refresh(), refreshInterval) : null;
@@ -3083,10 +3243,22 @@ function useBillLifecycle({
     }
   }, []);
   const openAttachment = useCallback3(async (attachment) => {
-    downloadBlob(await client.getAttachment(attachment.id), attachment.filename, true);
+    const preview = reservePreviewWindow();
+    try {
+      previewBlob(await client.getAttachment(attachment.id), preview);
+    } catch (error2) {
+      preview?.close();
+      throw error2;
+    }
   }, [client]);
   const openEor = useCallback3(async (document2) => {
-    downloadBlob(await client.getEor(document2.id), document2.filename, true);
+    const preview = reservePreviewWindow();
+    try {
+      previewBlob(await client.getEor(document2.id), preview);
+    } catch (error2) {
+      preview?.close();
+      throw error2;
+    }
   }, [client]);
   const downloadPacket = useCallback3(async () => {
     const packet = await client.getPacket();
@@ -3115,7 +3287,7 @@ function useBillLifecycle({
 }
 function LifecycleDialog({ children, title, onClose }) {
   const dialog = useRef4(null);
-  useEffect4(() => {
+  useEffect5(() => {
     const previous = document.activeElement;
     dialog.current?.focus();
     const onKeyDown = (event) => event.key === "Escape" && onClose();
@@ -3156,14 +3328,14 @@ function sandboxScenarios(state) {
 function ConnectedBillLifecycle({ appearance, className, style, loadingFallback, errorFallback, onChanged, ...options }) {
   const lifecycle = useBillLifecycle(options);
   const { data } = lifecycle;
-  const [tab, setTab] = useState5("details");
-  const [panel, setPanel] = useState5("");
-  const [notice, setNotice] = useState5("");
-  const [reason, setReason] = useState5("");
-  const [payment, setPayment] = useState5({ amount: 0, method: "check", checkNumber: "", depositDate: today(), note: "" });
-  const [review, setReview] = useState5({ reason: "", payerClaimControlNumber: "", disputedAmount: void 0, attachmentIds: [], route: "ebill" });
+  const [tab, setTab] = useState6("details");
+  const [panel, setPanel] = useState6("");
+  const [notice, setNotice] = useState6("");
+  const [reason, setReason] = useState6("");
+  const [payment, setPayment] = useState6({ amount: 0, method: "check", checkNumber: "", depositDate: today(), note: "" });
+  const [review, setReview] = useState6({ reason: "", payerClaimControlNumber: "", disputedAmount: void 0, attachmentIds: [], route: "ebill" });
   const lastData = useRef4(null);
-  useEffect4(() => {
+  useEffect5(() => {
     if (!data || data === lastData.current) return;
     lastData.current = data;
     onChanged?.(data);
@@ -3219,10 +3391,7 @@ function ConnectedBillLifecycle({ appearance, className, style, loadingFallback,
     ] }),
     /* @__PURE__ */ jsxs7("div", { className: "mb-lifecycle-tabs", role: "tablist", "aria-label": "Bill view", children: [
       /* @__PURE__ */ jsx7("button", { type: "button", role: "tab", "aria-selected": tab === "details", onClick: () => setTab("details"), children: "Bill details" }),
-      /* @__PURE__ */ jsxs7("button", { type: "button", role: "tab", "aria-selected": tab === "history", onClick: () => setTab("history"), children: [
-        "Bill history ",
-        /* @__PURE__ */ jsx7("span", { children: data.activity.length })
-      ] })
+      /* @__PURE__ */ jsx7("button", { type: "button", role: "tab", "aria-selected": tab === "history", onClick: () => setTab("history"), children: "Bill history" })
     ] }),
     data.environment === "sandbox" ? /* @__PURE__ */ jsxs7("section", { className: "mb-lifecycle-simulator", "aria-label": "Sandbox lifecycle simulator", children: [
       /* @__PURE__ */ jsxs7("div", { children: [
@@ -3253,20 +3422,24 @@ function ConnectedBillLifecycle({ appearance, className, style, loadingFallback,
           /* @__PURE__ */ jsx7("button", { type: "button", className: "mb-lifecycle-button secondary", onClick: () => void lifecycle.openEor(eor).catch(() => void 0), children: "View EOR" })
         ] }, eor.id)) })
       ] }) : null,
-      viewEor || actions.length ? /* @__PURE__ */ jsxs7("section", { className: "mb-lifecycle-actions-sheet", children: [
-        /* @__PURE__ */ jsxs7("div", { children: [
-          /* @__PURE__ */ jsx7("h3", { children: data.lifecycle.state.includes("closed") ? "This bill is closed" : data.lifecycle.state.includes("denied") || data.lifecycle.state.includes("rejected") ? "This bill needs attention" : "Available actions" }),
-          /* @__PURE__ */ jsx7("p", { children: "Actions are determined by the current bill status." })
-        ] }),
-        /* @__PURE__ */ jsxs7("div", { children: [
-          viewEor ? /* @__PURE__ */ jsx7("button", { type: "button", className: "mb-lifecycle-button secondary", onClick: () => document.getElementById(`mb-eors-${data.bill.id}`)?.scrollIntoView({ behavior: "smooth" }), children: viewEor.label }) : null,
-          actions.map((action) => /* @__PURE__ */ jsx7("button", { type: "button", className: action.primary ? "mb-lifecycle-button primary" : "mb-lifecycle-button secondary", onClick: () => {
-            const next = actionPanel(action);
-            if (next) setPanel(next);
-          }, children: action.label }, action.id))
-        ] })
-      ] }) : null
+      viewEor || actions.length ? /* @__PURE__ */ jsx7("button", { type: "button", className: "mb-lifecycle-button secondary mb-lifecycle-actions-trigger", onClick: () => setPanel("actions"), children: "Bill actions" }) : null
     ] }) : /* @__PURE__ */ jsx7("div", { className: "mb-lifecycle-tabpanel", role: "tabpanel", children: /* @__PURE__ */ jsx7(BillActivityTimeline, { events: data.activity, ...appearance ? { appearance } : {} }) }),
+    panel === "actions" ? /* @__PURE__ */ jsx7(LifecycleDialog, { title: "Bill actions", onClose: () => setPanel(""), children: /* @__PURE__ */ jsxs7("section", { className: "mb-lifecycle-panel mb-lifecycle-action-panel", children: [
+      /* @__PURE__ */ jsxs7("div", { children: [
+        /* @__PURE__ */ jsx7("h3", { children: "Bill actions" }),
+        /* @__PURE__ */ jsx7("p", { children: "Choose what you want to do with this bill." })
+      ] }),
+      /* @__PURE__ */ jsxs7("div", { className: "mb-lifecycle-action-options", children: [
+        viewEor ? /* @__PURE__ */ jsx7("button", { type: "button", className: "mb-lifecycle-button secondary", onClick: () => {
+          setPanel("");
+          document.getElementById(`mb-eors-${data.bill.id}`)?.scrollIntoView({ behavior: "smooth" });
+        }, children: viewEor.label }) : null,
+        actions.map((action) => /* @__PURE__ */ jsx7("button", { type: "button", className: action.primary ? "mb-lifecycle-button primary" : "mb-lifecycle-button secondary", onClick: () => {
+          const next = actionPanel(action);
+          if (next) setPanel(next);
+        }, children: action.label }, action.id))
+      ] })
+    ] }) }) : null,
     panel === "resubmit" ? /* @__PURE__ */ jsx7(LifecycleDialog, { title: "Correct and resubmit", onClose: () => setPanel(""), children: /* @__PURE__ */ jsxs7("section", { className: "mb-lifecycle-panel", children: [
       /* @__PURE__ */ jsxs7("div", { children: [
         /* @__PURE__ */ jsx7("h3", { children: "Correct and resubmit" }),
@@ -3380,7 +3553,7 @@ function ConnectedBillLifecycle({ appearance, className, style, loadingFallback,
 }
 var CONNECTED_LIFECYCLE_STYLES = `
 .mb-lifecycle-simulator{display:grid;gap:14px;padding:18px;border:1px solid #b8dadd;border-radius:var(--mb-radius,14px);background:#f2fbfb}.mb-lifecycle-simulator>div:first-child>span{color:var(--mb-accent);font-size:.72rem;font-weight:850;letter-spacing:.09em;text-transform:uppercase}.mb-lifecycle-simulator h3{margin:3px 0 0;font-size:1.05rem}.mb-lifecycle-simulator p{margin:4px 0 0;color:var(--mb-muted)}.mb-lifecycle-simulator-actions{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:10px}.mb-lifecycle-simulator-actions button{min-height:76px;border:1px solid #a9cccf;border-radius:10px;background:var(--mb-surface);color:var(--mb-text);cursor:pointer;padding:12px 14px;text-align:left;font:inherit}.mb-lifecycle-simulator-actions button:hover{border-color:var(--mb-accent);box-shadow:0 3px 14px rgba(23,108,112,.1)}.mb-lifecycle-simulator-actions button:disabled{cursor:not-allowed;opacity:.55}.mb-lifecycle-simulator-actions button strong,.mb-lifecycle-simulator-actions button span{display:block}.mb-lifecycle-simulator-actions button span{margin-top:3px;color:var(--mb-muted);font-size:.83rem}.mb-lifecycle-simulator-idle{padding:10px 12px;border-radius:8px;background:rgba(255,255,255,.72)}
-.mb-connected-lifecycle{--mb-accent:#176c70;--mb-text:#17282d;--mb-muted:#607176;--mb-border:#d7e0df;--mb-soft:#f4f7f6;--mb-surface:#fff;display:grid;gap:18px;color:var(--mb-text);font:14px/1.45 var(--mb-font,Inter,ui-sans-serif,system-ui,sans-serif)}.mb-connected-lifecycle *{box-sizing:border-box}.mb-lifecycle-head{display:flex;align-items:center;justify-content:space-between;gap:20px}.mb-lifecycle-title{display:flex;align-items:center;flex-wrap:wrap;gap:10px}.mb-lifecycle-title h2{margin:0;font-size:1.7rem}.mb-lifecycle-title span{border-radius:999px;background:var(--mb-soft);padding:5px 10px;font-weight:750}.mb-lifecycle-head p{margin:3px 0 0;color:var(--mb-muted)}.mb-lifecycle-tabs{display:grid;grid-template-columns:1fr 1fr;border:1px solid var(--mb-border);border-radius:12px;background:var(--mb-surface);padding:6px}.mb-lifecycle-tabs button{min-height:46px;border:0;border-radius:8px;background:transparent;color:var(--mb-muted);font:inherit;font-size:1rem;font-weight:750;cursor:pointer}.mb-lifecycle-tabs button[aria-selected=true]{background:var(--mb-accent);color:white}.mb-lifecycle-tabs span{display:inline-grid;place-items:center;min-width:24px;height:24px;margin-left:6px;border-radius:999px;background:rgba(127,127,127,.14);font-size:.8rem}.mb-lifecycle-tabpanel{display:grid;gap:18px}.mb-lifecycle-button{min-height:40px;border:1px solid var(--mb-border);border-radius:var(--mb-control-radius,8px);background:var(--mb-input,#fff);color:var(--mb-text);cursor:pointer;font:inherit;font-weight:750;padding:9px 14px}.mb-lifecycle-button.primary{border-color:var(--mb-accent);background:var(--mb-accent);color:var(--mb-accent-contrast,#fff)}.mb-lifecycle-button:disabled{cursor:not-allowed;opacity:.5}.mb-lifecycle-card,.mb-lifecycle-actions-sheet,.mb-lifecycle-panel{padding:20px;border:1px solid var(--mb-border);border-radius:var(--mb-radius,14px);background:var(--mb-surface)}.mb-lifecycle-card header,.mb-lifecycle-actions-sheet{display:flex;align-items:center;justify-content:space-between;gap:20px}.mb-lifecycle-card h3,.mb-lifecycle-actions-sheet h3,.mb-lifecycle-panel h3{margin:0;font-size:1.08rem}.mb-lifecycle-card p,.mb-lifecycle-actions-sheet p,.mb-lifecycle-panel p{margin:3px 0 0;color:var(--mb-muted)}.mb-lifecycle-card header>span{display:grid;place-items:center;min-width:28px;height:28px;border-radius:999px;background:var(--mb-soft);font-weight:750}.mb-lifecycle-actions-sheet>div:last-child{display:flex;flex-wrap:wrap;justify-content:flex-end;gap:8px}.mb-lifecycle-documents{list-style:none;margin:14px 0 0;padding:0}.mb-lifecycle-documents li{display:flex;align-items:center;justify-content:space-between;gap:14px;padding:12px 0;border-top:1px solid var(--mb-border)}.mb-lifecycle-documents li>div{display:grid;gap:3px;min-width:0}.mb-lifecycle-documents li span{color:var(--mb-muted);font-size:.85rem}.mb-lifecycle-dialog-backdrop{position:fixed;z-index:2147483000;inset:0;display:grid;place-items:center;padding:20px;background:rgba(18,35,43,.56);backdrop-filter:blur(3px)}.mb-lifecycle-dialog{position:relative;width:min(760px,100%);max-height:calc(100vh - 40px);overflow:auto;outline:0}.mb-lifecycle-dialog-close{position:absolute;z-index:1;top:12px;right:12px;width:34px;height:34px;border:1px solid var(--mb-border);border-radius:8px;background:var(--mb-surface);color:var(--mb-text);cursor:pointer;font:22px/1 inherit}.mb-lifecycle-panel{display:grid;gap:17px;padding-top:24px;box-shadow:0 24px 70px rgba(18,35,43,.22)}.mb-lifecycle-panel label{display:grid;gap:6px;font-size:.85rem;font-weight:750}.mb-lifecycle-panel label small{color:var(--mb-muted);font-weight:500}.mb-lifecycle-panel input,.mb-lifecycle-panel select,.mb-lifecycle-panel textarea{width:100%;min-height:44px;border:1px solid var(--mb-border);border-radius:var(--mb-control-radius,8px);background:var(--mb-input,#fff);color:var(--mb-text);font:inherit;padding:10px 12px}.mb-lifecycle-panel textarea{min-height:100px;resize:vertical}.mb-lifecycle-fields{display:grid;gap:13px}.mb-lifecycle-fields.two{grid-template-columns:repeat(2,minmax(0,1fr))}.mb-lifecycle-fields .full{grid-column:1/-1}.mb-lifecycle-panel-actions{display:flex;justify-content:flex-end;gap:8px}.mb-lifecycle-packet{display:grid;gap:0;margin:0;padding:0;border:0}.mb-lifecycle-packet legend{margin-bottom:7px;font-size:.85rem;font-weight:800}.mb-lifecycle-packet>label{display:grid;grid-template-columns:auto 1fr auto;align-items:center;gap:10px;padding:10px 2px;border-top:1px solid var(--mb-border)}.mb-lifecycle-packet>label>input{width:16px;min-height:16px}.mb-lifecycle-packet>label>span{display:grid}.mb-lifecycle-packet button{border:0;background:transparent;color:var(--mb-accent);cursor:pointer;font:inherit}.mb-lifecycle-message,.mb-lifecycle-error,.mb-lifecycle-loading{padding:12px 14px;border-radius:9px}.mb-lifecycle-message.success{background:#edf9f2;color:#217449}.mb-lifecycle-message.error,.mb-lifecycle-error{background:#fff0ef;color:#9d3029}.mb-lifecycle-error{display:flex;align-items:center;gap:12px}.mb-lifecycle-error span{flex:1}.mb-lifecycle-error button{border:1px solid currentColor;border-radius:7px;background:transparent;color:inherit;padding:7px 10px}
+.mb-connected-lifecycle{--mb-accent:#176c70;--mb-text:#17282d;--mb-muted:#607176;--mb-border:#d7e0df;--mb-soft:#f4f7f6;--mb-surface:#fff;display:grid;gap:18px;color:var(--mb-text);font:14px/1.45 var(--mb-font,Inter,ui-sans-serif,system-ui,sans-serif)}.mb-connected-lifecycle *{box-sizing:border-box}.mb-lifecycle-head{display:flex;align-items:center;justify-content:space-between;gap:20px}.mb-lifecycle-title{display:flex;align-items:center;flex-wrap:wrap;gap:10px}.mb-lifecycle-title h2{margin:0;font-size:1.7rem}.mb-lifecycle-title span{border-radius:999px;background:var(--mb-soft);padding:5px 10px;font-weight:750}.mb-lifecycle-head p{margin:3px 0 0;color:var(--mb-muted)}.mb-lifecycle-tabs{display:grid;grid-template-columns:1fr 1fr;border:1px solid var(--mb-border);border-radius:12px;background:var(--mb-surface);padding:6px}.mb-lifecycle-tabs button{min-height:46px;border:0;border-radius:8px;background:transparent;color:var(--mb-muted);font:inherit;font-size:1rem;font-weight:750;cursor:pointer}.mb-lifecycle-tabs button[aria-selected=true]{background:var(--mb-accent);color:white}.mb-lifecycle-tabpanel{display:grid;gap:18px}.mb-lifecycle-button{min-height:40px;border:1px solid var(--mb-border);border-radius:var(--mb-control-radius,8px);background:var(--mb-input,#fff);color:var(--mb-text);cursor:pointer;font:inherit;font-weight:750;padding:9px 14px}.mb-lifecycle-button.primary{border-color:var(--mb-accent);background:var(--mb-accent);color:var(--mb-accent-contrast,#fff)}.mb-lifecycle-button:disabled{cursor:not-allowed;opacity:.5}.mb-lifecycle-actions-trigger{width:100%}.mb-lifecycle-card,.mb-lifecycle-panel{padding:20px;border:1px solid var(--mb-border);border-radius:var(--mb-radius,14px);background:var(--mb-surface)}.mb-lifecycle-card header{display:flex;align-items:center;justify-content:space-between;gap:20px}.mb-lifecycle-card h3,.mb-lifecycle-panel h3{margin:0;font-size:1.08rem}.mb-lifecycle-card p,.mb-lifecycle-panel p{margin:3px 0 0;color:var(--mb-muted)}.mb-lifecycle-card header>span{display:grid;place-items:center;min-width:28px;height:28px;border-radius:999px;background:var(--mb-soft);font-weight:750}.mb-lifecycle-action-options{display:grid;gap:10px}.mb-lifecycle-action-options .mb-lifecycle-button{width:100%}.mb-lifecycle-documents{list-style:none;margin:14px 0 0;padding:0}.mb-lifecycle-documents li{display:flex;align-items:center;justify-content:space-between;gap:14px;padding:12px 0;border-top:1px solid var(--mb-border)}.mb-lifecycle-documents li>div{display:grid;gap:3px;min-width:0}.mb-lifecycle-documents li span{color:var(--mb-muted);font-size:.85rem}.mb-lifecycle-dialog-backdrop{position:fixed;z-index:2147483000;inset:0;display:grid;place-items:center;padding:20px;background:rgba(18,35,43,.56);backdrop-filter:blur(3px)}.mb-lifecycle-dialog{position:relative;width:min(760px,100%);max-height:calc(100vh - 40px);overflow:auto;outline:0}.mb-lifecycle-dialog-close{position:absolute;z-index:1;top:12px;right:12px;width:34px;height:34px;border:1px solid var(--mb-border);border-radius:8px;background:var(--mb-surface);color:var(--mb-text);cursor:pointer;font:22px/1 inherit}.mb-lifecycle-panel{display:grid;gap:17px;padding-top:24px;box-shadow:0 24px 70px rgba(18,35,43,.22)}.mb-lifecycle-panel label{display:grid;gap:6px;font-size:.85rem;font-weight:750}.mb-lifecycle-panel label small{color:var(--mb-muted);font-weight:500}.mb-lifecycle-panel input,.mb-lifecycle-panel select,.mb-lifecycle-panel textarea{width:100%;min-height:44px;border:1px solid var(--mb-border);border-radius:var(--mb-control-radius,8px);background:var(--mb-input,#fff);color:var(--mb-text);font:inherit;padding:10px 12px}.mb-lifecycle-panel textarea{min-height:100px;resize:vertical}.mb-lifecycle-fields{display:grid;gap:13px}.mb-lifecycle-fields.two{grid-template-columns:repeat(2,minmax(0,1fr))}.mb-lifecycle-fields .full{grid-column:1/-1}.mb-lifecycle-panel-actions{display:flex;justify-content:flex-end;gap:8px}.mb-lifecycle-packet{display:grid;gap:0;margin:0;padding:0;border:0}.mb-lifecycle-packet legend{margin-bottom:7px;font-size:.85rem;font-weight:800}.mb-lifecycle-packet>label{display:grid;grid-template-columns:auto 1fr auto;align-items:center;gap:10px;padding:10px 2px;border-top:1px solid var(--mb-border)}.mb-lifecycle-packet>label>input{width:16px;min-height:16px}.mb-lifecycle-packet>label>span{display:grid}.mb-lifecycle-packet button{border:0;background:transparent;color:var(--mb-accent);cursor:pointer;font:inherit}.mb-lifecycle-message,.mb-lifecycle-error,.mb-lifecycle-loading{padding:12px 14px;border-radius:9px}.mb-lifecycle-message.success{background:#edf9f2;color:#217449}.mb-lifecycle-message.error,.mb-lifecycle-error{background:#fff0ef;color:#9d3029}.mb-lifecycle-error{display:flex;align-items:center;gap:12px}.mb-lifecycle-error span{flex:1}.mb-lifecycle-error button{border:1px solid currentColor;border-radius:7px;background:transparent;color:inherit;padding:7px 10px}
 @media(max-width:700px){.mb-lifecycle-head,.mb-lifecycle-actions-sheet,.mb-lifecycle-card header{align-items:stretch;flex-direction:column}.mb-lifecycle-head>.mb-lifecycle-button{width:100%}.mb-lifecycle-actions-sheet>div:last-child{justify-content:stretch}.mb-lifecycle-actions-sheet .mb-lifecycle-button{width:100%}.mb-lifecycle-fields.two{grid-template-columns:1fr}.mb-lifecycle-fields .full{grid-column:auto}.mb-lifecycle-dialog-backdrop{align-items:end;padding:0}.mb-lifecycle-dialog{max-height:92vh}.mb-lifecycle-dialog .mb-lifecycle-panel{border-radius:18px 18px 0 0}.mb-lifecycle-tabs button{font-size:.9rem}.mb-lifecycle-title h2{font-size:1.4rem}}
 `;
 
@@ -3388,7 +3561,7 @@ var CONNECTED_LIFECYCLE_STYLES = `
 function widget(tagName, props) {
   const ref = useRef5(null);
   const { onMindBill, onMindBillError } = props;
-  useEffect5(() => {
+  useEffect6(() => {
     const element = ref.current;
     if (!element) return;
     const handleEvent = (event) => onMindBill?.(event);
@@ -3455,6 +3628,7 @@ export {
   ConnectedBillStatus,
   DEFAULT_BILL_SUBMISSION_MODIFIERS,
   DEFAULT_BILL_SUBMISSION_PROCEDURES,
+  DEFAULT_BILL_SUBMISSION_TAXONOMIES,
   MED_LEGAL_REPORT_TYPE_CODE,
   MindBillBillReview,
   MindBillBillTimeline,