@npm-zenwork/tax-remittance-ui 0.2.5 → 0.3.0

package/dist/api/bankAccounts.d.ts

@@ -3,10 +3,10 @@ import { CreateBankAccountRequest, UpdateBankAccountRequest } from '../types/cre
 /**
  * The entity's bank accounts.
  *
- * The backend paginates this endpoint, but every `['bank-accounts', entityId]`
- * consumer filters/paginates the full list client-side, so this fetches every
- * account in one page rather than threading server-side paging through those
- * call sites.
+ * GET /portal/bank-accounts returns a paged envelope in `data`
+ * (BankAccountController.List). Every `['bank-accounts', entityId]` consumer
+ * filters/paginates client-side, so this requests one large page and unwraps
+ * it to a bare array rather than exposing pagination to callers.
  */
 export declare function getBankAccounts(entityId: number): Promise<BankAccountResponse[]>;
 export declare function createBankAccount(request: CreateBankAccountRequest): Promise<BankAccountResponse>;

package/dist/api/dashboard.d.ts

@@ -1,5 +1,7 @@
-import { DashboardPaymentsPage, DashboardPaymentsQuery, DashboardResponse, MonthlyOverview, PaymentCategorySummary } from '../types/dashboard';
+import { DashboardCharts, DashboardOverview, DashboardPaymentsPage, DashboardPaymentsQuery, DashboardResponse, MonthlyOverview, PaymentCategorySummary } from '../types/dashboard';
 export declare function getDashboard(entityId: number, taxYear?: number): Promise<DashboardResponse>;
 export declare function getDashboardSummary(entityId: number, category: string, taxYear: number): Promise<PaymentCategorySummary>;
 export declare function getDashboardMonthlyOverview(entityId: number, month: number, year?: number): Promise<MonthlyOverview>;
 export declare function getDashboardPayments({ entityId, search, taxYear, status, page, pageSize, }: DashboardPaymentsQuery): Promise<DashboardPaymentsPage>;
+export declare function getDashboardOverview(entityId: number, taxYear?: number): Promise<DashboardOverview>;
+export declare function getDashboardCharts(entityId: number, taxYear?: number): Promise<DashboardCharts>;

package/dist/api/entities.d.ts

@@ -8,11 +8,11 @@ interface CreateEntityDetailsResponse {
 /**
  * The caller's entity list.
  *
- * The backend supports real search/pagination on this endpoint, but this is what
- * backs the shared `['entities', 'mine']` query used by EmbeddedContext, the
- * entity list page and the entity form — all of which filter/paginate a full
- * list client-side, so this fetches every entity in one page rather than
- * threading server-side paging through those call sites.
+ * GET /portal/entities/mine returns a paged envelope in `data`
+ * (EntitiesController.GetMine). Backs the shared `['entities', 'mine']` query
+ * used by EmbeddedContext, the entity list page and the entity form, all of
+ * which filter/paginate client-side, so this requests one large page and
+ * unwraps it to a bare array rather than exposing pagination to callers.
  */
 export declare function getAllMyEntities(): Promise<EntityDetailsResponse[]>;
 export declare function createEntity(request: CreateEntityDetailsRequest): Promise<CreateEntityDetailsResponse>;

package/dist/api/remittancePayments.d.ts

@@ -11,7 +11,8 @@ export interface RemittancePaymentResponse {
     paymentDate: string;
     status: string | null;
     reason: string | null;
-    /** Federal tax form / state reason for payment — not served by the API yet. */
+    /** Federal IRS form type, or the state agency form actually chosen for the payment
+     * (falls back to Reason for Payment when no form applies, e.g. Bill Payment). */
     formType?: string | null;
 }
 export interface RemittancePaymentStatusCounts {

package/dist/api/statePayments.d.ts

@@ -18,6 +18,15 @@ export declare function getStatePaymentStates(signal?: AbortSignal): Promise<Sta
 export declare function getStatePaymentReasons(entityId: number, state: string, signal?: AbortSignal): Promise<StatePaymentReasonOption[]>;
 export declare function getStatePaymentValidationMetadata(entityId: number, state: string, reason: string, signal?: AbortSignal): Promise<StatePaymentFormMetadata>;
 export declare function getStatePaymentFormReferences(entityId: number, state: string, reason: string, signal?: AbortSignal): Promise<StatePaymentFormReferences>;
+/**
+ * Suggests occurrence dates for a recurring series on the rule-scoped Deposit Frequency
+ * vocabulary (frequencyCode from validation-metadata's frequencyOptions) — a convenience the
+ * caller reviews/edits before submitting as explicit Occurrences[] rows. Replaces the legacy
+ * IsRecurring/Frequency/RecurringEndDate server-generated path; see the State Payment Rules
+ * plan, point 4. Rejects (422) when the frequency has no unambiguous fixed interval to generate
+ * from (e.g. SEMI_WEEKLY) — the caller falls back to adding rows manually in that case.
+ */
+export declare function getStatePaymentOccurrenceDates(entityId: number, state: string, reason: string, frequencyCode: string, startDate: string, endDate: string, signal?: AbortSignal): Promise<string[]>;
 export declare function getStatePayments({ entityId, status, pageNumber, pageSize, }: GetStatePaymentsQuery): Promise<PagedResult<StatePaymentResponse>>;
 export declare function getStatePaymentStatusCounts(entityId: number): Promise<StatePaymentStatusCounts>;
 export declare function getStatePaymentById(statePaymentDetailId: number): Promise<StatePaymentResponse>;

package/dist/api/taxAccounts.d.ts

@@ -2,10 +2,19 @@ import { CreateTaxAccountRequest, TaxAccountDetailResponse, UpdateTaxAccountRequ
 import { PagedResult } from '../types/pagination';
 export interface GetTaxAccountsQuery {
     entityId: number;
+    state?: string;
+    reasonForPayment?: string;
+    status?: string;
     pageNumber?: number;
     pageSize?: number;
 }
-export declare function getTaxAccounts({ entityId, pageNumber, pageSize, }: GetTaxAccountsQuery): Promise<PagedResult<TaxAccountDetailResponse>>;
+/**
+ * Lists tax accounts for an entity. When `state` and `reasonForPayment` are
+ * both supplied, this is also the State Payment autobind lookup — the
+ * EntityId+State+ReasonForPayment unique index guarantees at most one item
+ * comes back.
+ */
+export declare function getTaxAccounts({ entityId, state, reasonForPayment, status, pageNumber, pageSize, }: GetTaxAccountsQuery): Promise<PagedResult<TaxAccountDetailResponse>>;
 export declare function getTaxAccount(taxAccountDetailId: number): Promise<TaxAccountDetailResponse>;
 export declare function createTaxAccount(request: CreateTaxAccountRequest): Promise<TaxAccountDetailResponse>;
 export declare function updateTaxAccount(taxAccountDetailId: number, request: UpdateTaxAccountRequest): Promise<TaxAccountDetailResponse>;

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

@@ -0,0 +1,10 @@
+import { DashboardKpi } from './dashboardMockData';
+interface DashboardKpiCardsProps {
+    items: DashboardKpi[];
+}
+/**
+ * Top row of the redesigned dashboard: four at-a-glance figures.
+ * Each card is label / value / caption with no chrome beyond a hairline border.
+ */
+export declare function DashboardKpiCards({ items }: DashboardKpiCardsProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,11 @@
+import { TaxYearOption } from './dashboardUtils';
+import { FederalQuarterPoint } from './dashboardMockData';
+interface FederalPaymentsChartCardProps {
+    points: FederalQuarterPoint[];
+    /** Owned by the dashboard page — changing it refetches `points` for that year. */
+    taxYear: number;
+    taxYearOptions: TaxYearOption[];
+    onTaxYearChange: (taxYear: number) => void;
+}
+export declare function FederalPaymentsChartCard({ points, taxYear, taxYearOptions, onTaxYearChange, }: FederalPaymentsChartCardProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,6 @@
+import { AttentionAlert } from './dashboardMockData';
+interface NeedAttentionCarouselProps {
+    alerts: AttentionAlert[];
+}
+export declare function NeedAttentionCarousel({ alerts }: NeedAttentionCarouselProps): import("react").JSX.Element | null;
+export {};

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

@@ -0,0 +1,7 @@
+import { PaymentTypeBar } from './dashboardMockData';
+interface PaymentsTypeCardProps {
+    bars: PaymentTypeBar[];
+    year: number;
+}
+export declare function PaymentsTypeCard({ bars, year }: PaymentsTypeCardProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,6 @@
+import { RecentPaymentRow } from './dashboardMockData';
+interface RecentPaymentsCardProps {
+    payments: RecentPaymentRow[];
+}
+export declare function RecentPaymentsCard({ payments }: RecentPaymentsCardProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,13 @@
+export interface RowAction {
+    key: string;
+    label: string;
+    onSelect: () => void;
+}
+interface RowActionsMenuProps {
+    /** Accessible name, e.g. "Actions for IRS — Federal Q2 2026". */
+    label: string;
+    actions: RowAction[];
+}
+/** The `⋮` row menu used by the Recent and Upcoming payment lists. */
+export declare function RowActionsMenu({ label, actions }: RowActionsMenuProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,11 @@
+import { TaxYearOption } from './dashboardUtils';
+import { StatePaymentSlice } from './dashboardMockData';
+interface StatePaymentsChartCardProps {
+    slices: StatePaymentSlice[];
+    /** Owned by the dashboard page — changing it refetches `slices` for that year. */
+    taxYear: number;
+    taxYearOptions: TaxYearOption[];
+    onTaxYearChange: (taxYear: number) => void;
+}
+export declare function StatePaymentsChartCard({ slices, taxYear, taxYearOptions, onTaxYearChange, }: StatePaymentsChartCardProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,9 @@
+import { TaxYearOption } from './dashboardUtils';
+interface TaxYearSelectProps {
+    value: number;
+    options: TaxYearOption[];
+    onChange: (value: number) => void;
+}
+/** Calendar-icon year picker sitting in the Federal and State chart headers. */
+export declare function TaxYearSelect({ value, options, onChange }: TaxYearSelectProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,6 @@
+import { UpcomingPaymentRow } from './dashboardMockData';
+interface UpcomingPaymentsCardProps {
+    payments: UpcomingPaymentRow[];
+}
+export declare function UpcomingPaymentsCard({ payments }: UpcomingPaymentsCardProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,63 @@
+import { DashboardPaymentStatus } from './dashboardUtils';
+export interface AttentionAlert {
+    /** Composite `category-id`, unique across both payment categories. */
+    id: string;
+    /** The payment this alert is about — the View / Re-Submit buttons open it. */
+    paymentId: number;
+    category: string;
+    amount: number;
+    /** Why it needs attention, e.g. `Payment Rejected`. */
+    reason: string;
+    /** Meta line parts, joined with `·` — jurisdiction, tax type, period. */
+    details: string[];
+    /** Label on the primary (red) action button. */
+    actionLabel: string;
+}
+export interface DashboardKpi {
+    key: string;
+    label: string;
+    value: string;
+    caption: string;
+    tone: 'default' | 'danger';
+}
+export interface RecentPaymentRow {
+    id: string;
+    jurisdiction: string;
+    period: string;
+    paymentDate: string;
+    /** Drives the badge colour; `statusLabel` is what the badge prints. */
+    status: DashboardPaymentStatus;
+    statusLabel: string;
+    formType: string;
+    amount: number;
+}
+export interface UpcomingPaymentRow {
+    id: string;
+    /** Three-letter month for the date chip, e.g. `JUL`. */
+    month: string;
+    /** Day of month for the date chip, e.g. `31`. */
+    day: string;
+    title: string;
+    dueLabel: string;
+    jurisdiction: string;
+    amount: number;
+}
+export interface FederalQuarterPoint {
+    label: string;
+    amount: number;
+}
+export interface StatePaymentSlice {
+    state: string;
+    count: number;
+    amount: number;
+    /** Donut segment + legend dot colour. Category colours, not theme colours. */
+    color: string;
+}
+export interface PaymentTypeBar {
+    /** Printed verbatim — the design only shows a percentage on some rows. */
+    label: string;
+    amount: number;
+    /** Bar fill width, 0-100. */
+    percent: number;
+    color: string;
+}

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

@@ -0,0 +1,15 @@
+import { DashboardNeedsAttentionItem, DashboardPaymentItem, DashboardUpcomingPayment, FederalQuarterAmount, StateJurisdictionAmount, StatePaymentTypeAmount } from '../../types/dashboard';
+import { AttentionAlert, FederalQuarterPoint, PaymentTypeBar, RecentPaymentRow, StatePaymentSlice, UpcomingPaymentRow } from './dashboardMockData';
+/** `2026-09-26` -> `09-26-2026`, matching the redesigned dashboard's table style. */
+export declare function formatDashboardDate(isoDate: string): string;
+/**
+ * item.status/statusLabel are already the backend's canonical dashboard bucket
+ * (`"paid" | "scheduled" | "submitted" | "failed" | "draft"`) and its display
+ * label — no re-derivation needed, just carried through.
+ */
+export declare function mapRecentPaymentRow(item: DashboardPaymentItem): RecentPaymentRow;
+export declare function mapUpcomingPaymentRow(payment: DashboardUpcomingPayment, today?: Date): UpcomingPaymentRow;
+export declare function mapNeedsAttentionAlerts(items: DashboardNeedsAttentionItem[]): AttentionAlert[];
+export declare function mapFederalQuarterPoints(rows: FederalQuarterAmount[]): FederalQuarterPoint[];
+export declare function mapStatePaymentSlices(rows: StateJurisdictionAmount[]): StatePaymentSlice[];
+export declare function mapPaymentTypeBars(rows: StatePaymentTypeAmount[]): PaymentTypeBar[];

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

@@ -20,6 +20,24 @@ export interface PaymentCategorySummary {
     percentDone: number;
 }
 export declare function formatDashboardCurrency(amount: number): string;
+/**
+ * Currency with cents always shown. The redesigned dashboard tables and charts
+ * print `$12,450.00` rather than dropping `.00`, unlike formatDashboardCurrency.
+ */
+export declare function formatDashboardAmount(amount: number): string;
+export interface TaxYearOption {
+    /** The year sent to the charts endpoint. */
+    value: number;
+    label: string;
+}
+/**
+ * Builds the `Current TY 2026 / TY 2025 / TY 2024` choices for the chart card
+ * headers. The numeric `value` is what the dashboard queries key on — the
+ * label is display only.
+ */
+export declare function buildTaxYearOptions(currentYear: number): TaxYearOption[];
+/** Compact currency used by the State Payments legend, e.g. `$90.4k`. */
+export declare function formatDashboardCompact(amount: number): string;
 export declare function normalizePaymentStatus(status: string | null): DashboardPaymentStatus;
 export declare function getStatusLabel(status: DashboardPaymentStatus, rawStatus?: string | null): string;
 export declare function mapFederalPaymentToRow(payment: FederalPaymentResponse): DashboardPaymentRow;

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

@@ -3,6 +3,11 @@ interface UseSetupProgressArgs {
     entityId: number | null;
     entityCount: number;
     dashboard: DashboardResponse | undefined;
+    /**
+     * 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.
+     */
+    userName?: string;
 }
 export interface SetupProgress {
     hasEntity: boolean;
@@ -21,5 +26,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, }: UseSetupProgressArgs): SetupProgress;
+export declare function useSetupProgress({ entityId, entityCount, dashboard, userName, }: UseSetupProgressArgs): SetupProgress;
 export {};

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

@@ -1,20 +1,11 @@
 import { EntityDetailsResponse } from '../../types/entity';
-export declare function formatEin(idNumber: string): string;
-export declare function formatSsn(idNumber: string): string;
-/** Mask an EIN for display, revealing only the last 4 digits: `**-***6789`. */
-export declare function maskEin(idNumber: string): string;
-/** Mask an SSN for display, revealing only the last 4 digits: `***-**-6789`. */
-export declare function maskSsn(idNumber: string): string;
-/** Mask a stored 9-digit id for display: SSN shape for Individual, EIN otherwise. */
-export declare function maskIdNumber(idNumber: string, accountType: string): string;
-/** Format a stored 9-digit id for display: SSN for Individual, EIN otherwise. */
-export declare function formatIdNumber(idNumber: string, accountType: string): string;
 /**
- * Format an id as the user types — strips non-digits, caps at 9 digits, and
- * inserts dashes for the appropriate mask (SSN `XXX-XX-XXXX`, EIN `XX-XXXXXXX`).
+ * Taxpayer-id and phone formatting now lives in `@/lib/fieldRules`, alongside
+ * the validation rules for the same fields, so the two can never drift apart.
+ * Re-exported here because the entity, settings and payment screens already
+ * import them from this module.
  */
-export declare function formatIdNumberInput(value: string, accountType: string): string;
-export declare function formatPhone(phoneNumber: string): string;
+export { formatEin, formatSsn, maskEin, maskSsn, maskIdNumber, formatIdNumber, formatIdNumberInput, formatPhone, } from '../../lib/fieldRules';
 export declare function formatJoinedDate(date: string): string;
 export declare function getJoinedYear(date: string): string;
 export declare function matchesEntitySearch(entity: EntityDetailsResponse, query: string): boolean;

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

@@ -1,16 +1,14 @@
-import { InputHTMLAttributes, SelectHTMLAttributes } from 'react';
+import { InputHTMLAttributes } from 'react';
 interface PhoneInputGroupProps {
     label?: string;
     required?: boolean;
     error?: string;
-    countryCodeSelectProps: SelectHTMLAttributes<HTMLSelectElement>;
     phoneInputProps: InputHTMLAttributes<HTMLInputElement>;
 }
 /**
- * Country-code select + phone number input rendered as one connected control
- * with a shared focus ring, instead of two visually disconnected inputs.
- * countryCode and phoneNumber stay separate registered fields — this is a
- * purely visual grouping.
+ * Phone number input with a shared focus ring on its wrapper.
+ * The country code is not user-editable — forms keep it in state as "+1" and
+ * prefix it onto the number when building the API payload.
  */
-export declare function PhoneInputGroup({ label, required, error, countryCodeSelectProps, phoneInputProps, }: PhoneInputGroupProps): import("react").JSX.Element;
+export declare function PhoneInputGroup({ label, required, error, phoneInputProps, }: PhoneInputGroupProps): import("react").JSX.Element;
 export {};

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

@@ -10,17 +10,17 @@ interface SegmentedControlProps<T extends string> {
     options: SegmentedControlOption<T>[];
     value: T;
     onChange: (value: T) => void;
-    /** false renders compact, content-width buttons instead of stretching to fill the row. */
+    /** false hugs the option labels instead of filling the column. */
     fullWidth?: boolean;
     /** Fires when any option receives focus — lets a contextual help panel follow the group. */
     onFocus?: () => void;
 }
 /**
  * Accessible segmented control (WAI-ARIA radiogroup pattern) for a small,
- * mutually-exclusive set of options — e.g. Account Type. Renders as equal-width
- * bordered cards (not a compact pill toggle) so it reads clearly at any
- * viewport width, from a full row on desktop down to two narrow cards on
- * mobile. Generic — not tied to any specific option set.
+ * mutually-exclusive set of options — e.g. Account Type. The options share one
+ * bordered track and split it evenly, so the control matches the height and
+ * width of an input sitting beside it in the same grid row. Generic — not tied
+ * to any specific option set.
  */
 export declare function SegmentedControl<T extends string>({ label, required, options, value, onChange, fullWidth, onFocus, }: SegmentedControlProps<T>): import("react").JSX.Element;
 export {};

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

@@ -4,11 +4,13 @@ interface EntityAccountTypeRowProps {
     accountType: EntityFormValues['accountType'];
     onAccountTypeChange: (next: EntityFormValues['accountType']) => void;
     isIndividual: boolean;
-    filingStatus: string;
-    onFilingStatusChange: (value: string) => void;
+    filingStatus?: string;
+    onFilingStatusChange?: (value: string) => void;
     focusHelp: (key: HelpKey) => () => void;
     resetHelp: () => void;
+    /** Off where filing status isn't part of the payload (edit flow). */
+    showFilingStatus?: boolean;
 }
 /** Account Type toggle, plus Filing Status for individual accounts. */
-export declare function EntityAccountTypeRow({ accountType, onAccountTypeChange, isIndividual, filingStatus, onFilingStatusChange, focusHelp, resetHelp, }: EntityAccountTypeRowProps): import("react").JSX.Element;
+export declare function EntityAccountTypeRow({ accountType, onAccountTypeChange, isIndividual, filingStatus, onFilingStatusChange, focusHelp, resetHelp, showFilingStatus, }: EntityAccountTypeRowProps): import("react").JSX.Element;
 export {};

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

@@ -6,8 +6,6 @@ interface EntityBusinessFieldsProps {
     errors: FieldErrors<EntityFormValues>;
     einRegister: UseFormRegisterReturn;
     phoneRegister: UseFormRegisterReturn;
-    countryCodeRegister: UseFormRegisterReturn;
-    entityTypeOptions: string[];
     accountType: string;
     idLabel: string;
     idPlaceholder: string;
@@ -15,5 +13,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, countryCodeRegister, entityTypeOptions, accountType, idLabel, idPlaceholder, idMaxLength, focusHelp, }: EntityBusinessFieldsProps): import("react").JSX.Element;
+export declare function EntityBusinessFields({ register, errors, einRegister, phoneRegister, accountType, idLabel, idPlaceholder, idMaxLength, focusHelp, }: EntityBusinessFieldsProps): import("react").JSX.Element;
 export {};

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

@@ -1,10 +1,9 @@
 import { UseFormRegisterReturn } from 'react-hook-form';
 interface EntityPhoneFieldProps {
-    countryCodeRegister: UseFormRegisterReturn;
     phoneRegister: UseFormRegisterReturn;
     error?: string;
     onFocus: () => void;
 }
-/** Country code + 10-digit phone number, stripped to digits as the user types. */
-export declare function EntityPhoneField({ countryCodeRegister, phoneRegister, error, onFocus, }: EntityPhoneFieldProps): import("react").JSX.Element;
+/** National phone number, stripped to digits as the user types. */
+export declare function EntityPhoneField({ phoneRegister, error, onFocus }: EntityPhoneFieldProps): import("react").JSX.Element;
 export {};

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

@@ -5,7 +5,6 @@ interface EntityPrimaryTaxpayerFieldsProps {
     errors: FieldErrors<EntityFormValues>;
     einRegister: UseFormRegisterReturn;
     phoneRegister: UseFormRegisterReturn;
-    countryCodeRegister: UseFormRegisterReturn;
     accountType: string;
     idLabel: string;
     idPlaceholder: string;
@@ -13,5 +12,5 @@ interface EntityPrimaryTaxpayerFieldsProps {
     resetHelp: () => void;
 }
 /** Individual account fields: the primary taxpayer's name, SSN and contact details. */
-export declare function EntityPrimaryTaxpayerFields({ register, errors, einRegister, phoneRegister, countryCodeRegister, accountType, idLabel, idPlaceholder, idMaxLength, resetHelp, }: EntityPrimaryTaxpayerFieldsProps): import("react").JSX.Element;
+export declare function EntityPrimaryTaxpayerFields({ register, errors, einRegister, phoneRegister, accountType, idLabel, idPlaceholder, idMaxLength, resetHelp, }: EntityPrimaryTaxpayerFieldsProps): import("react").JSX.Element;
 export {};

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

@@ -1,5 +1,5 @@
 import { ChangeEvent } from 'react';
-import { AddressParts, SecondaryTaxpayer } from '../../lib/entityFormUtils';
+import { AddressParts, SecondaryTaxpayer, SecondaryTaxpayerErrors } from '../../lib/entityFormUtils';
 import { StateOption } from '../../lib/useAddressReference';
 type SecondaryField = keyof Omit<SecondaryTaxpayer, 'sameAsPrimaryAddress'>;
 interface SecondaryTaxpayerSectionProps {
@@ -9,6 +9,8 @@ interface SecondaryTaxpayerSectionProps {
         country: string;
     };
     stateOptions: StateOption[];
+    /** Per-field messages, populated on submit. */
+    errors: SecondaryTaxpayerErrors;
     onFieldChange: (field: SecondaryField) => (event: ChangeEvent<HTMLInputElement | HTMLSelectElement>) => void;
     onSsnChange: (value: string) => void;
     onSameAsPrimaryChange: (checked: boolean) => void;
@@ -17,5 +19,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, onFieldChange, onSsnChange, onSameAsPrimaryChange, }: SecondaryTaxpayerSectionProps): import("react").JSX.Element;
+export declare function SecondaryTaxpayerSection({ values, address, stateOptions, errors, onFieldChange, onSsnChange, onSameAsPrimaryChange, }: SecondaryTaxpayerSectionProps): import("react").JSX.Element;
 export {};

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

@@ -0,0 +1,10 @@
+interface SecondaryTaxpayerToggleProps {
+    checked: boolean;
+    onChange: (checked: boolean) => void;
+}
+/**
+ * Opt-in for the joint filer's details. Shown for Individual + "Married Filing
+ * Jointly"; the fields themselves stay hidden until this is ticked.
+ */
+export declare function SecondaryTaxpayerToggle({ checked, onChange }: SecondaryTaxpayerToggleProps): import("react").JSX.Element;
+export {};

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

@@ -20,14 +20,12 @@ export declare function useEntityForm(): {
     einRegister: import('react-hook-form').UseFormRegisterReturn<"ein">;
     phoneRegister: import('react-hook-form').UseFormRegisterReturn<"phoneNumber">;
     zipRegister: import('react-hook-form').UseFormRegisterReturn<"zipCode">;
-    countryCodeRegister: import('react-hook-form').UseFormRegisterReturn<"countryCode">;
     accountType: "Business" | "Individual";
     isIndividual: boolean;
     isUS: boolean;
     idLabel: string;
     idPlaceholder: string;
     idMaxLength: number;
-    entityTypeOptions: string[];
     stateOptions: import('../../lib/useAddressReference').StateOption[];
     state: string;
     zipStateMismatch: boolean;
@@ -56,7 +54,11 @@ export declare function useEntityForm(): {
     focusHelp: (key: HelpKey) => () => void;
     resetHelp: () => void;
     filingStatus: string;
-    setFilingStatus: import('react').Dispatch<import('react').SetStateAction<string>>;
+    setFilingStatus: (next: string) => void;
+    canAddSecondaryTaxpayer: boolean;
+    includeSecondaryTaxpayer: boolean;
+    setIncludeSecondaryTaxpayer: (checked: boolean) => void;
+    secondaryErrors: Partial<Record<"state" | "country" | "email" | "firstName" | "lastName" | "address1" | "address2" | "city" | "zipCode" | "ssn" | "phone", string>>;
     showSecondaryTaxpayer: boolean;
     secondaryTaxpayer: SecondaryTaxpayer;
     secondaryAddress: {

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

@@ -0,0 +1,14 @@
+import { FederalPaymentDraft } from '../../types/federalPaymentFlow';
+interface FederalPaymentReviewPanelProps {
+    entityId: number | null;
+    paymentDraft: FederalPaymentDraft;
+}
+/**
+ * Read-only recap of step 1 for the Review & Submit step. Labels, asterisks and
+ * info copy mirror AddFederalPaymentForm so the review reads like the form the
+ * values came from; the values themselves are resolved through the same cached
+ * reference queries, falling back to the raw draft when a lookup isn't
+ * available (e.g. a draft opened straight from the payments list).
+ */
+export declare function FederalPaymentReviewPanel({ entityId, paymentDraft, }: FederalPaymentReviewPanelProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,13 @@
+import { EntityDetailsResponse } from '../../types/entity';
+import { FederalPaymentDraft } from '../../types/federalPaymentFlow';
+interface FederalPaymentReviewStepProps {
+    entity: EntityDetailsResponse | null;
+    paymentDraft: FederalPaymentDraft;
+}
+/**
+ * Step 3 of the federal flow — a read-only recap of what steps 1 and 2 saved,
+ * with the final submit to the IRS. The payment and its authorization are
+ * already persisted as a draft by step 2, so this screen only submits.
+ */
+export declare function FederalPaymentReviewStep({ entity, paymentDraft }: FederalPaymentReviewStepProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,43 @@
+/**
+ * Action row shared by the federal and state payment steps, pinned to the bottom
+ * of the page so the primary action stays reachable on these long forms.
+ *
+ * "Save as Draft" is a split control: the label saves and leaves, while the
+ * chevron opens the destructive alternative (Discard Payment) rather than
+ * spending a third button on it. The menu opens upward — the bar sits at the
+ * bottom of the viewport, so there is no room below it.
+ */
+interface BackAction {
+    /** `Back` on later steps, `Cancel` on the first one. */
+    label: string;
+    onClick: () => void;
+    /** Later steps go back to a previous step, so they show the arrow. */
+    showArrow?: boolean;
+    disabled?: boolean;
+}
+interface DraftAction {
+    onSave: () => void;
+    onDiscard: () => void;
+    isSaving?: boolean;
+    disabled?: boolean;
+}
+interface SubmitAction {
+    /** `Next` on the first two steps, `Submit Payment` on the last. */
+    label: string;
+    disabled?: boolean;
+    isSubmitting?: 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.
+     */
+    onClick?: () => void;
+}
+interface PaymentActionsFooterProps {
+    back?: BackAction;
+    /** Omitted when the payment is being viewed rather than filled in. */
+    draft?: DraftAction;
+    /** Omitted when the payment is being viewed rather than filled in. */
+    submit?: SubmitAction;
+}
+export declare function PaymentActionsFooter({ back, draft, submit, }: PaymentActionsFooterProps): import("react").JSX.Element;
+export {};

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

@@ -1,16 +1,12 @@
 interface RecurringPaymentToggleProps {
     enabled: boolean;
     onChange: (enabled: boolean) => void;
-    frequency: string;
-    endDate: string;
-    onEndDateChange: (endDate: string) => void;
-    endDateError?: string;
     disabled?: boolean;
 }
 /**
- * "Make This a Recurring Payment" panel. When enabled, the backend generates
- * one scheduled payment per occurrence of the chosen frequency, up to the end
- * date entered here.
+ * "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
+ * its own Tax Period, Tax Amount, and Payment Date, submitted together as one series.
  */
-export declare function RecurringPaymentToggle({ enabled, onChange, frequency, endDate, onEndDateChange, endDateError, disabled, }: RecurringPaymentToggleProps): import("react").JSX.Element;
+export declare function RecurringPaymentToggle({ enabled, onChange, disabled, }: RecurringPaymentToggleProps): import("react").JSX.Element;
 export {};