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

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

@@ -77,4 +77,10 @@ export declare function useEntityForm(): {
     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/CustomSelect.d.ts

@@ -0,0 +1,25 @@
+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;
+}
+/**
+ * The one dropdown implementation every field in the State Payment form shares, so hover/focus/
+ * selected styling stays identical everywhere (border-gov-400 / bg-gov-50, matching the app's
+ * existing 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.
+ */
+export declare function CustomSelect({ value, onChange, options, placeholder, disabled, hasError, loading, loadingLabel, }: CustomSelectProps): import("react").JSX.Element;
+export {};

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
  * 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/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 Zenwork 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/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/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).