@npm-zenwork/tax-remittance-ui 0.4.3 → 0.5.1

package/dist/components/dashboard/PaymentsTypeCard.d.ts

@@ -1,7 +1,11 @@
+import { TaxYearOption } from './dashboardUtils';
 import { PaymentTypeBar } from './dashboardMockData';
 interface PaymentsTypeCardProps {
     bars: PaymentTypeBar[];
-    year: number;
+    /** Owned by the dashboard page, independent of the other chart cards' years. */
+    taxYear: number;
+    taxYearOptions: TaxYearOption[];
+    onTaxYearChange: (taxYear: number) => void;
 }
-export declare function PaymentsTypeCard({ bars, year }: PaymentsTypeCardProps): import("react").JSX.Element;
+export declare function PaymentsTypeCard({ bars, taxYear, taxYearOptions, onTaxYearChange }: PaymentsTypeCardProps): import("react").JSX.Element;
 export {};

package/dist/components/dashboard/useSetupProgress.d.ts

@@ -2,7 +2,11 @@ import { DashboardResponse } from '../../types/dashboard';
 interface UseSetupProgressArgs {
     entityId: number | null;
     entityCount: number;
+    /** True while the entities list itself is still loading. */
+    entitiesLoading: boolean;
     dashboard: DashboardResponse | undefined;
+    /** True while the selected entity's dashboard summary is still loading. */
+    dashboardLoading: boolean;
     /**
      * Full name of the signed-in user, when the host app supplies one. Embedded
      * hosts own the session, so the widget's own storage is empty there.
@@ -15,6 +19,14 @@ export interface SetupProgress {
     hasBankAccount: boolean;
     hasAuthorizedPayment: boolean;
     isComplete: boolean;
+    /**
+     * True until every signal `isComplete` depends on — entities, and (once an
+     * entity is selected) its dashboard summary and bank accounts — has loaded
+     * at least once. Callers must wait for this before branching on
+     * `isComplete`, otherwise the checklist flashes true/false/true as each
+     * query resolves at a different time (e.g. right after login).
+     */
+    isLoading: boolean;
     /** First name of the signed-in user, when the session carries one. */
     userName?: string;
 }
@@ -26,5 +38,5 @@ export interface SetupProgress {
  * are filled in, and scheduling happens later from the drafts tab. The API has
  * no separate authorization flag to read.
  */
-export declare function useSetupProgress({ entityId, entityCount, dashboard, userName, }: UseSetupProgressArgs): SetupProgress;
+export declare function useSetupProgress({ entityId, entityCount, entitiesLoading, dashboard, dashboardLoading, userName, }: UseSetupProgressArgs): SetupProgress;
 export {};

package/dist/components/entities/EntityCard.d.ts

@@ -3,6 +3,12 @@ interface EntityCardProps {
     entity: EntityDetailsResponse;
     selected: boolean;
     onEdit: (entity: EntityDetailsResponse) => void;
+    /**
+     * Optional — when provided, the card body becomes clickable and switches the
+     * active entity (matching the header's entity switcher). Callers that don't
+     * need "click to switch" (e.g. a read-only listing) can omit this prop.
+     */
+    onSelect?: (entity: EntityDetailsResponse) => void;
 }
-export declare function EntityCard({ entity, selected, onEdit }: EntityCardProps): import("react").JSX.Element;
+export declare function EntityCard({ entity, selected, onEdit, onSelect }: EntityCardProps): import("react").JSX.Element;
 export {};

package/dist/components/forms/CustomSelect.d.ts

@@ -0,0 +1,40 @@
+import { ReactNode } from 'react';
+export interface CustomSelectOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+    /** Small pill shown to the right of the label (e.g. "Coming Soon") — plain text, no markup. */
+    badge?: string;
+}
+interface CustomSelectProps {
+    value: string;
+    onChange: (value: string) => void;
+    options: CustomSelectOption[];
+    placeholder: string;
+    disabled?: boolean;
+    hasError?: boolean;
+    loading?: boolean;
+    loadingLabel?: string;
+    /**
+     * Renders the control with its own label and error line. Omit it when the
+     * caller already provides those — inside a `PaymentField`, say.
+     */
+    label?: string;
+    required?: boolean;
+    error?: string;
+    id?: string;
+    ariaLabel?: string;
+    /** `sm` is the compact inline control toolbars use (pagination, chart headers). */
+    size?: 'md' | 'sm';
+    /** Icon pinned inside the control's left edge, as on the tax-year picker. */
+    leadingIcon?: ReactNode;
+}
+/**
+ * The one dropdown in the app. Every select goes through it so hover/focus/selected
+ * styling stays identical everywhere (border-gov-400 / bg-gov-50, matching the app's
+ * focus-ring accent) — a native <select>'s option list is OS-rendered chrome the page
+ * can't restyle, and can't show a badge (see the Reason for Payment "Coming Soon"
+ * case) at all. Change it here and every dropdown changes with it.
+ */
+export declare function CustomSelect({ value, onChange, options, placeholder, disabled, hasError, loading, loadingLabel, label, required, error, id, ariaLabel, size, leadingIcon, }: CustomSelectProps): import("react").JSX.Element;
+export {};

package/dist/components/forms/FormField.d.ts

@@ -1,4 +1,4 @@
-import { InputHTMLAttributes, ReactNode, SelectHTMLAttributes } from 'react';
+import { InputHTMLAttributes, ReactNode } from 'react';
 export interface FormLabelProps {
     label: string;
     required?: boolean;
@@ -13,13 +13,6 @@ interface FormInputProps extends InputHTMLAttributes<HTMLInputElement> {
     tooltip?: string;
 }
 export declare const FormInput: import('react').ForwardRefExoticComponent<FormInputProps & import('react').RefAttributes<HTMLInputElement>>;
-interface FormSelectProps extends SelectHTMLAttributes<HTMLSelectElement> {
-    label: string;
-    required?: boolean;
-    error?: string;
-    children: ReactNode;
-}
-export declare const FormSelect: import('react').ForwardRefExoticComponent<FormSelectProps & import('react').RefAttributes<HTMLSelectElement>>;
 interface FormSectionProps {
     step?: number;
     title: string;

package/dist/components/forms/PhoneNumberInput.d.ts

@@ -0,0 +1,27 @@
+import { ChangeEvent, FocusEventHandler } from 'react';
+import { UseFormRegisterReturn } from 'react-hook-form';
+interface PhoneNumberInputProps {
+    label?: string;
+    required?: boolean;
+    error?: string;
+    /** Chrome only: `payment` matches the IRS-form fields, everything else uses `default`. */
+    variant?: 'default' | 'payment';
+    placeholder?: string;
+    id?: string;
+    name?: string;
+    readOnly?: boolean;
+    disabled?: boolean;
+    onFocus?: FocusEventHandler<HTMLInputElement>;
+    /** react-hook-form registration — omit for a controlled field. */
+    register?: UseFormRegisterReturn;
+    /** Controlled value/handler — omit when `register` is given. */
+    value?: string;
+    onChange?: (event: ChangeEvent<HTMLInputElement>) => void;
+}
+/**
+ * The only phone number input in the app. Every phone field goes through it so
+ * they all mask alike (`+1 (479) 555-0123`), cap at the same length and accept
+ * digits only — change it here and every form changes with it.
+ */
+export declare function PhoneNumberInput({ label, required, error, variant, placeholder, id, name, readOnly, disabled, onFocus, register, value, onChange, }: PhoneNumberInputProps): import("react").JSX.Element;
+export {};

package/dist/components/onboarding/EntityAddressFields.d.ts

@@ -1,9 +1,10 @@
-import { FieldErrors, UseFormRegister, UseFormRegisterReturn } from 'react-hook-form';
+import { Control, FieldErrors, UseFormRegister, UseFormRegisterReturn } from 'react-hook-form';
 import { StateOption } from '../../lib/useAddressReference';
 import { EntityFormValues } from '../../types/entity';
 import { HelpKey } from './entityHelpContent';
 interface EntityAddressFieldsProps {
     register: UseFormRegister<EntityFormValues>;
+    control: Control<EntityFormValues>;
     errors: FieldErrors<EntityFormValues>;
     zipRegister: UseFormRegisterReturn;
     isUS: boolean;
@@ -13,5 +14,5 @@ interface EntityAddressFieldsProps {
     focusHelp: (key: HelpKey) => () => void;
 }
 /** Registered address for the entity — labels and formatting follow the country. */
-export declare function EntityAddressFields({ register, errors, zipRegister, isUS, state, stateOptions, zipStateMismatch, focusHelp, }: EntityAddressFieldsProps): import("react").JSX.Element;
+export declare function EntityAddressFields({ register, control, errors, zipRegister, isUS, state, stateOptions, zipStateMismatch, focusHelp, }: EntityAddressFieldsProps): import("react").JSX.Element;
 export {};

package/dist/components/onboarding/EntityBusinessFields.d.ts

@@ -1,8 +1,9 @@
-import { FieldErrors, UseFormRegister, UseFormRegisterReturn } from 'react-hook-form';
+import { Control, FieldErrors, UseFormRegister, UseFormRegisterReturn } from 'react-hook-form';
 import { EntityFormValues } from '../../types/entity';
 import { HelpKey } from './entityHelpContent';
 interface EntityBusinessFieldsProps {
     register: UseFormRegister<EntityFormValues>;
+    control: Control<EntityFormValues>;
     errors: FieldErrors<EntityFormValues>;
     einRegister: UseFormRegisterReturn;
     phoneRegister: UseFormRegisterReturn;
@@ -13,5 +14,5 @@ interface EntityBusinessFieldsProps {
     focusHelp: (key: HelpKey) => () => void;
 }
 /** Business account fields: names, contact details, entity type and EIN. */
-export declare function EntityBusinessFields({ register, errors, einRegister, phoneRegister, accountType, idLabel, idPlaceholder, idMaxLength, focusHelp, }: EntityBusinessFieldsProps): import("react").JSX.Element;
+export declare function EntityBusinessFields({ register, control, errors, einRegister, phoneRegister, accountType, idLabel, idPlaceholder, idMaxLength, focusHelp, }: EntityBusinessFieldsProps): import("react").JSX.Element;
 export {};

package/dist/components/onboarding/SecondaryTaxpayerSection.d.ts

@@ -12,6 +12,8 @@ interface SecondaryTaxpayerSectionProps {
     /** Per-field messages, populated on submit. */
     errors: SecondaryTaxpayerErrors;
     onFieldChange: (field: SecondaryField) => (event: ChangeEvent<HTMLInputElement | HTMLSelectElement>) => void;
+    /** Value-based counterpart, for controls that report a value rather than an event. */
+    onFieldValueChange: (field: SecondaryField, value: string) => void;
     onSsnChange: (value: string) => void;
     onSameAsPrimaryChange: (checked: boolean) => void;
 }
@@ -19,5 +21,5 @@ interface SecondaryTaxpayerSectionProps {
  * Joint-filer details, shown for Individual + "Married Filing Jointly".
  * UI-only — nothing here is submitted yet (see SecondaryTaxpayer).
  */
-export declare function SecondaryTaxpayerSection({ values, address, stateOptions, errors, onFieldChange, onSsnChange, onSameAsPrimaryChange, }: SecondaryTaxpayerSectionProps): import("react").JSX.Element;
+export declare function SecondaryTaxpayerSection({ values, address, stateOptions, errors, onFieldChange, onFieldValueChange, onSsnChange, onSameAsPrimaryChange, }: SecondaryTaxpayerSectionProps): import("react").JSX.Element;
 export {};

package/dist/components/onboarding/entityHelpContent.d.ts

@@ -9,7 +9,7 @@ export interface FieldHelp {
     mistake?: string;
 }
 /**
- * Per-field copy for the "How to fill this" side panel — keyed by a help key
+ * Per-field copy for the "How to fill this" side panel - keyed by a help key
  * set on each input's onFocus. Fields without an entry here fall back to the
  * panel's generic copy.
  */

package/dist/components/onboarding/useEntityForm.d.ts

@@ -13,6 +13,7 @@ export interface CreatedEntitySnapshot {
  */
 export declare function useEntityForm(): {
     register: import('react-hook-form').UseFormRegister<EntityFormValues>;
+    control: import('react-hook-form').Control<EntityFormValues, any, EntityFormValues>;
     errors: import('react-hook-form').FieldErrors<EntityFormValues>;
     onSubmit: (e?: React.BaseSyntheticEvent) => Promise<void>;
     error: string | null;
@@ -71,10 +72,17 @@ export declare function useEntityForm(): {
     };
     secondaryStateOptions: import('../../lib/useAddressReference').StateOption[];
     updateSecondaryField: <K extends keyof Omit<SecondaryTaxpayer, "sameAsPrimaryAddress">>(field: K) => (event: ChangeEvent<HTMLInputElement | HTMLSelectElement>) => void;
+    setSecondaryField: <K extends keyof Omit<SecondaryTaxpayer, "sameAsPrimaryAddress">>(field: K, value: string) => void;
     setSecondarySsn: (value: string) => void;
     setSecondarySameAsPrimary: (checked: boolean) => void;
     createdEntity: CreatedEntitySnapshot | null;
     handleAccountTypeChange: (next: EntityFormValues["accountType"]) => void;
     handleCancel: () => void;
     goToDashboard: () => void;
+    enabledPayments: import('../../embedded/EmbeddedContext').PaymentType[];
+    isPaymentPickerOpen: boolean;
+    startPayment: () => void;
+    closePaymentPicker: () => void;
+    startFederalPayment: () => void;
+    startStatePayment: () => void;
 };

package/dist/components/payments/PaymentActionsFooter.d.ts

@@ -26,6 +26,12 @@ interface SubmitAction {
     label: string;
     disabled?: boolean;
     isSubmitting?: boolean;
+    /**
+     * Set false where the submit is blocked by something that does not make the
+     * step unsaveable — an unticked consent box, say: the payment is filled in
+     * and worth keeping as a draft, the taxpayer just has not agreed yet.
+     */
+    blocksDraft?: boolean;
     /**
      * Steps that are a `<form>` leave this off and let the button submit. The
      * federal review step is a plain `<div>`, so it passes its handler here.

package/dist/components/payments/PaymentField.d.ts

@@ -15,7 +15,7 @@ interface PaymentFieldProps {
 }
 export declare function PaymentField({ label, required, error, info, children }: PaymentFieldProps): import("react").JSX.Element;
 export declare function paymentInputClass(hasError?: boolean, readOnly?: boolean): string;
-export declare function paymentSelectClass(hasError?: boolean): string;
+export declare function paymentSelectClass(hasError?: boolean, readOnly?: boolean): string;
 declare function ChevronDownIcon({ className }: {
     className?: string;
 }): import("react").JSX.Element;

package/dist/components/payments/RecurringPaymentToggle.d.ts

@@ -2,11 +2,12 @@ interface RecurringPaymentToggleProps {
     enabled: boolean;
     onChange: (enabled: boolean) => void;
     disabled?: boolean;
+    helperText?: string;
 }
 /**
  * "Make This a Recurring Payment" panel. When enabled, the caller adds each occurrence
- * explicitly ("+ Add New" in the Tax Periods & Amounts section below) — every occurrence keeps
+ * explicitly ("+ Add New" in the Tax Periods & Amounts section below) - every occurrence keeps
  * its own Tax Period, Tax Amount, and Payment Date, submitted together as one series.
  */
-export declare function RecurringPaymentToggle({ enabled, onChange, disabled, }: RecurringPaymentToggleProps): import("react").JSX.Element;
+export declare function RecurringPaymentToggle({ enabled, onChange, disabled, helperText, }: RecurringPaymentToggleProps): import("react").JSX.Element;
 export {};

package/dist/components/payments/SignatureFieldGroup.d.ts

@@ -5,15 +5,20 @@ interface SignatureFieldGroupProps {
     signature: UseFormRegisterReturn;
     title: UseFormRegisterReturn;
     date: UseFormRegisterReturn;
+    /** Adds a signer-name cell between the signature and the title — state authorizations ask for it. */
+    signerName?: UseFormRegisterReturn;
+    signerNameCaption?: string;
+    signerNamePlaceholder?: string;
     signatureValue: string;
     dateValue?: string;
     dateReadOnly?: boolean;
     errors?: {
         signature?: string;
+        signerName?: string;
         title?: string;
         date?: string;
     };
     signatureCaption?: string;
 }
-export declare function SignatureFieldGroup({ label, required, signature, title, date, signatureValue, dateValue, dateReadOnly, errors, signatureCaption, }: SignatureFieldGroupProps): import("react").JSX.Element;
+export declare function SignatureFieldGroup({ label, required, signature, title, date, signerName, signerNameCaption, signerNamePlaceholder, signatureValue, dateValue, dateReadOnly, errors, signatureCaption, }: SignatureFieldGroupProps): import("react").JSX.Element;
 export {};

package/dist/components/payments/federalSubcategoryRules.d.ts

@@ -26,6 +26,13 @@ export declare function getSubcategoryCodeLabels(taxFormType: string): {
 export declare function isValidAmountField(value: string): boolean;
 export declare function sanitizeFederalAmountInput(raw: string): string;
 export declare function parseAmountField(value: string): number | null;
+/**
+ * Settle a half-typed amount when the field loses focus: `123` becomes
+ * `123.00`, `123.4` becomes `123.40`, `12.` becomes `12.00`. An empty field is
+ * left empty — a blank is "not filled in yet", not zero — and anything that
+ * isn't a number is returned untouched so validation can report it as typed.
+ */
+export declare function formatAmountFieldOnBlur(value: string): string;
 export declare function sumSubcategoryAmounts(amount1: string, amount2: string, amount3: string, includeAmount3: boolean): number;
 export declare function amountsEqual(left: number, right: number): boolean;
 /** Maps subcategory amounts to IRS API codes ("1", "2", "3") per Tax1099 backend. */

package/dist/components/payments/reportingAgentAuthorizationConfig.d.ts

@@ -1,7 +1,11 @@
 export declare const authorizationTaxForms: readonly ["720", "940", "941", "943", "944", "945", "990-PF", "990-T", "1041", "1042", "1120", "CT-1"];
 export type AuthorizationTaxForm = (typeof authorizationTaxForms)[number];
-/** Line 16 of Form 8655 only lists these forms — no "Other" option exists on the
- *  real form, so an unmatched tax form type is left unselected. */
-export declare function resolveAuthorizedTaxForm(taxFormType: string): AuthorizationTaxForm | '';
+/** Everything Line 16 of Form 8655 doesn't list falls under this option. */
+export declare const otherAuthorizationTaxForm = "Other";
+/** Line 16 of Form 8655 lists the forms above; anything else is authorized
+ *  under "Other", which carries the form type through as-is. */
+export declare function resolveAuthorizedTaxForm(taxFormType: string): string;
+/** True once a form type is set but isn't one Line 16 names. */
+export declare function isOtherAuthorizedTaxForm(value: string): boolean;
 export declare const authorizationAgreementLead = "I understand that this agreement does not relieve me, as the taxpayer, of the responsibility to ensure that all tax returns are filed and that all deposits and payments are made and that I may enroll in the Electronic Federal Tax Payment System (EFTPS) to view deposits and payments made on my behalf.";
 export declare const authorizationAgreementBody = "I further understand that this agreement does not authorize the reporting agent to sign any tax returns, to otherwise act as a legal representative of the taxpayer, or to represent the taxpayer before the IRS. I also understand that the reporting agent is not responsible for any penalties or interest that may be assessed against the taxpayer. I authorize the reporting agent to complete Form 8655, Reporting Agent Authorization, and to make deposits and payments on my behalf for the tax return(s) indicated above. I also authorize the reporting agent to receive confidential information and to perform acts as specified on Form 2848, Power of Attorney and Declaration of Representative, or Form 8821, Tax Information Authorization, as applicable.";

package/dist/components/payments/statePaymentAuthorizationConfig.d.ts

@@ -1,2 +1,3 @@
-export declare const statePaymentAuthorizationText = "Before your payment is processed, please review the information carefully. By proceeding, you authorize to initiate this payment to the selected tax authority using your chosen bank account. You acknowledge that you are responsible for ensuring the accuracy of the payment information and for complying with all applicable tax filing and payment requirements.";
-export declare const statePaymentAuthorizationCheckboxLabel = "I have reviewed the details and authorize this payment.";
+export declare const statePaymentAuthorizationIntro = "By signing below, you authorize Govpay Payments to initiate this tax payment using the payment details you provided.";
+export declare const statePaymentAuthorizationAcknowledgements: string[];
+export declare const statePaymentAuthorizationClosing = "By signing, you confirm that you are authorized to act on behalf of the taxpayer or business listed above.";

package/dist/components/settings/EditEntityForm.d.ts

@@ -6,7 +6,7 @@ interface EditEntityFormProps {
 }
 /**
  * Edit Entity form — same composition as the Add Entity form (EntityForm), with
- * the identifier locked and no filing status, which the update payload omits.
+ * the identifier locked. Filing Status is editable here too, same as at creation.
  */
 export declare function EditEntityForm({ entity, onCancel, onSaved }: EditEntityFormProps): import("react").JSX.Element;
 export {};

package/dist/components/settings/TaxAccountDrawer.d.ts

@@ -14,9 +14,11 @@ export type TaxAccountDrawerValues = z.infer<typeof taxAccountSchema>;
 interface TaxAccountDrawerProps {
     open: boolean;
     entityId: number | null;
-    /** When set, the drawer edits this account instead of creating one. */
+    /** When set, the drawer edits (or, with `readOnly`, displays) this account instead of creating one. */
     account?: TaxAccountDetailResponse | null;
+    /** Renders every field disabled with a single "Close" action — the Figma "View" state. */
+    readOnly?: boolean;
     onClose: () => void;
 }
-export declare function TaxAccountDrawer({ open, entityId, account, onClose }: TaxAccountDrawerProps): import("react").JSX.Element;
+export declare function TaxAccountDrawer({ open, entityId, account, readOnly, onClose }: TaxAccountDrawerProps): import("react").JSX.Element;
 export {};

package/dist/components/ui/useAnchoredLayer.d.ts

@@ -0,0 +1,35 @@
+import { CSSProperties, RefObject } from 'react';
+interface AnchoredLayerOptions {
+    open: boolean;
+    /** The trigger the layer hangs off. */
+    anchorRef: RefObject<HTMLElement | null>;
+    /** The floating element itself — needed so a click inside it is not "outside". */
+    layerRef: RefObject<HTMLElement | null>;
+    onDismiss: () => void;
+    /** `anchor` matches the trigger's width (dropdowns); a number pins it (menus). */
+    width?: number | 'anchor';
+    /** `end` right-aligns the layer with the trigger, as row menus do. */
+    align?: 'start' | 'end';
+    gap?: number;
+    /** Caps a scrolling list; omit for menus, which are measured instead. */
+    maxHeight?: number;
+}
+/**
+ * Positions a floating layer against its trigger in viewport coordinates, for
+ * use with a portal. Anything rendered this way is immune to the two things
+ * that break an `absolute` popup: an ancestor's `overflow` clipping it (the
+ * payments table scroller) and a later sibling's stacking context painting over
+ * it. Repositions while the page or a drawer scrolls, and handles dismissal on
+ * outside click and Escape.
+ *
+ * Returns `null` until the first measurement, so callers render nothing yet.
+ */
+export declare function useAnchoredLayer({ open, anchorRef, layerRef, onDismiss, width, align, gap, maxHeight, }: AnchoredLayerOptions): CSSProperties | null;
+/**
+ * Where a floating layer is mounted. The widget's own root rather than
+ * `document.body`: the `--embedded-*` tokens the gov-* palette reads are scoped
+ * to `.tax-remittance-embedded`, and outside it those colours fall back to the
+ * unthemed defaults.
+ */
+export declare function getLayerHost(anchor: HTMLElement | null): HTMLElement | null;
+export {};

package/dist/embedded/EmbeddedLayout.d.ts

@@ -10,9 +10,7 @@ export interface PortalOutletContext {
     setSelectedEntityId: (entityId: number) => void;
 }
 /**
- * Minimal shell for the embedded widget — no sidebar, no header branding.
- * Renders a compact top bar with:
- *   - Entity selector (dropdown) when multiple entities exist
- *   - Back button when on a sub-page
+ * Minimal shell for the embedded widget — no sidebar, no header branding, no
+ * top bar. Each page carries its own heading and back affordance.
  */
 export declare function EmbeddedLayout(): import("react").JSX.Element;

package/dist/embedded/EmbeddedWidgetBase.d.ts

@@ -13,6 +13,8 @@ export interface EmbeddedWidgetBaseProps {
     onOrganizationCreated?: (org: EntityDetailsResponse) => void;
     onNavigate?: (routeKey: EmbeddedRouteKey, pathname: string) => void;
     onPaymentRequired?: (info: PaymentRequiredInfo) => void;
+    /** Called whenever the widget's active entity changes, from either the host or the widget. */
+    onEntityChange?: (entity: EntityDetailsResponse) => void;
     navigateFnRef: MutableRefObject<((path: string) => void) | null>;
     selectEntityFnRef: MutableRefObject<((id: number) => void) | null>;
     /** Payment types this widget instance supports. Controls which dashboard action cards appear. */
@@ -32,4 +34,4 @@ export interface EmbeddedWidgetBaseProps {
  *
  * Children should be a <Routes> element with the widget-specific route tree.
  */
-export declare function EmbeddedWidgetBase({ appKey, accessToken, apiBaseUrl, theme, onSessionExpired, onOrganizationCreated, onNavigate, onPaymentRequired, navigateFnRef, selectEntityFnRef, enabledPayments, userName, children, }: EmbeddedWidgetBaseProps): import("react").JSX.Element;
+export declare function EmbeddedWidgetBase({ appKey, accessToken, apiBaseUrl, theme, onSessionExpired, onOrganizationCreated, onNavigate, onPaymentRequired, onEntityChange, navigateFnRef, selectEntityFnRef, enabledPayments, userName, children, }: EmbeddedWidgetBaseProps): import("react").JSX.Element;

package/dist/embedded/TaxRemittanceEmbedded.d.ts

@@ -82,6 +82,13 @@ export interface TaxRemittanceEmbeddedProps {
      * after the payment succeeds and schedule-after-payment has been called.
      */
     onPaymentRequired?: (info: PaymentRequiredInfo) => void;
+    /**
+     * Called whenever the widget's active entity changes — whether the host triggered it via
+     * `widgetRef.current?.selectEntity(id)`, or it happened inside the widget itself (e.g. the
+     * user clicked an entity card on the Entities list). Use this to keep the host app's own
+     * "current entity" state (a header switcher, breadcrumb, etc.) in sync with the widget.
+     */
+    onEntityChange?: (entity: EntityDetailsResponse) => void;
 }
 /**
  * Full embedded widget — all sections (dashboard, payments, tax forms, settings).