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

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/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/eftpsIndividualEnrollmentConfig.d.ts

@@ -1,4 +1,4 @@
-export declare const disclosureAuthorizationAgreementOne = "I hereby authorize the contact person listed in item 5 on this form, and the financial institution(s) listed in items 9-11 on this form, to process EFTPS payments and to receive confidential information for enrollment purposes, to answer inquiries regarding my account, and to resolve any issues that may arise. This authorization includes passwords, payment instructions, taxpayer names, and identifying numbers.";
-export declare const disclosureAuthorizationAgreementTwo = "By completing the financial institution information in items 9-11 on this form, I authorize the designated Financial Agents of the U.S. Treasury to initiate EFTPS debit entries to my financial institution account for federal tax payments. All debits will be made in accordance with U.S. Treasury regulations. This authorization remains in effect until written notification of termination is received and the Financial Agent has had a reasonable opportunity to act on it.";
-export declare const authorityToExecuteAgreement = "Under penalties of perjury, I certify that I have the authority to sign this authorization on behalf of the taxpayer. If I am a corporate officer, partner, guardian, executor, receiver, administrator, trustee, or other party, I certify that I have the authority to execute this authorization on behalf of the taxpayer. If I am a tax practitioner, I certify that Form 2848 or Form 8655 is on file with the IRS.";
+export declare const disclosureAuthorizationAgreement = "I hereby authorize the contact person listed in item 5 on this form and financial institutions involved in the processing of my Electronic Federal Tax Payment System (EFTPS) payments to receive confidential information necessary to effect enrollment in EFTPS, electronic payment of taxes, answer inquiries and resolve issues related to enrollment and payments. This information includes, but is not limited to, passwords, payment instructions, taxpayer name and identifying number, and payment transaction details. This authorization is to remain in full force and effect until the designated Financial Agents of the U.S. Treasury have received written notification from me of termination in such time and in such manner to afford a reasonable opportunity to act on it.";
+export declare const debitAuthorizationAgreement = "By completing the financial institution information in items 9-11 on this form, I authorize designated Financial Agents of the U.S. Treasury to initiate EFTPS debit entries to the financial institution account indicated above, for payment of federal taxes owed to the IRS upon request by Taxpayer or his/her representative, using the Electronic Federal Tax Payment System (EFTPS). I further authorize the financial institution named above to debit such entries to the financial institution account indicated above. All debits initiated by the U.S. Treasury designated Financial Agents pursuant to this authorization shall be made under U.S. Treasury regulations. This authorization is to remain in full force and effect until the designated Financial Agents of the U.S. Treasury have received written notification of termination in such time and in such manner as to afford a reasonable opportunity to act on it.";
+export declare const authorityToExecuteAgreement = "If signed by a corporate officer, partner, or fiduciary on behalf of the taxpayer, I certify that I have the authority to have payments made from the taxpayer\u2019s account. If signed by a representative of the taxpayer, I certify that I have the authority to execute this authorization on behalf of the taxpayer (i.e., authority provided by Form 2848, Power of Attorney and Declaration of Representative, or Form 8655, Reporting Agent Authorization for Magnetic Tape/Electronic Filers)";
 export declare const agiTaxYearOptions: string[];

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

@@ -0,0 +1,12 @@
+import { EntityDetailsResponse } from '../../types/entity';
+interface EditEntityFormProps {
+    entity: EntityDetailsResponse;
+    onCancel: () => void;
+    onSaved: () => void;
+}
+/**
+ * Edit Entity form — same composition as the Add Entity form (EntityForm), with
+ * the identifier locked and no filing status, which the update payload omits.
+ */
+export declare function EditEntityForm({ entity, onCancel, onSaved }: EditEntityFormProps): import("react").JSX.Element;
+export {};

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

@@ -3,9 +3,9 @@ import { TaxAccountDetailResponse } from '../../types/taxAccountDetails';
 declare const taxAccountSchema: z.ZodObject<{
     state: z.ZodString;
     reasonForPayment: z.ZodString;
+    stateAccountId: z.ZodString;
     accountId: z.ZodString;
-    stateTaxId: z.ZodString;
-    taxYear: z.ZodOptional<z.ZodString>;
+    taxYear: z.ZodString;
     frequency: z.ZodOptional<z.ZodString>;
     status: z.ZodString;
     notes: z.ZodOptional<z.ZodString>;

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

@@ -1,5 +1 @@
-/** Filing cadences offered for a tax account. */
-export declare const TAX_ACCOUNT_FREQUENCIES: readonly ["Monthly", "Quarterly", "Semi-Annually", "Annually"];
 export declare const TAX_ACCOUNT_STATUSES: readonly ["Active", "Inactive"];
-/** Current year and the four before it — the years an account can be filed for. */
-export declare function getTaxAccountYearOptions(): string[];