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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (70) hide show
  1. package/dist/api/bankAccounts.d.ts +4 -4
  2. package/dist/api/dashboard.d.ts +3 -1
  3. package/dist/api/entities.d.ts +5 -5
  4. package/dist/api/taxAccounts.d.ts +10 -1
  5. package/dist/components/dashboard/DashboardKpiCards.d.ts +10 -0
  6. package/dist/components/dashboard/FederalPaymentsChartCard.d.ts +11 -0
  7. package/dist/components/dashboard/NeedAttentionCarousel.d.ts +6 -0
  8. package/dist/components/dashboard/PaymentsTypeCard.d.ts +7 -0
  9. package/dist/components/dashboard/RecentPaymentsCard.d.ts +6 -0
  10. package/dist/components/dashboard/RowActionsMenu.d.ts +13 -0
  11. package/dist/components/dashboard/StatePaymentsChartCard.d.ts +11 -0
  12. package/dist/components/dashboard/TaxYearSelect.d.ts +9 -0
  13. package/dist/components/dashboard/UpcomingPaymentsCard.d.ts +6 -0
  14. package/dist/components/dashboard/dashboardMockData.d.ts +63 -0
  15. package/dist/components/dashboard/dashboardOverviewMappers.d.ts +15 -0
  16. package/dist/components/dashboard/dashboardUtils.d.ts +18 -0
  17. package/dist/components/dashboard/useSetupProgress.d.ts +6 -1
  18. package/dist/components/entities/entityListUtils.d.ts +5 -14
  19. package/dist/components/forms/PhoneInputGroup.d.ts +5 -7
  20. package/dist/components/forms/SegmentedControl.d.ts +5 -5
  21. package/dist/components/onboarding/EntityAccountTypeRow.d.ts +5 -3
  22. package/dist/components/onboarding/EntityBusinessFields.d.ts +1 -3
  23. package/dist/components/onboarding/EntityPhoneField.d.ts +2 -3
  24. package/dist/components/onboarding/EntityPrimaryTaxpayerFields.d.ts +1 -2
  25. package/dist/components/onboarding/SecondaryTaxpayerSection.d.ts +4 -2
  26. package/dist/components/onboarding/SecondaryTaxpayerToggle.d.ts +10 -0
  27. package/dist/components/onboarding/useEntityForm.d.ts +5 -3
  28. package/dist/components/payments/FederalPaymentReviewPanel.d.ts +14 -0
  29. package/dist/components/payments/FederalPaymentReviewStep.d.ts +13 -0
  30. package/dist/components/payments/PaymentActionsFooter.d.ts +43 -0
  31. package/dist/components/payments/eftpsIndividualEnrollmentConfig.d.ts +3 -3
  32. package/dist/components/settings/EditEntityForm.d.ts +12 -0
  33. package/dist/components/settings/TaxAccountDrawer.d.ts +2 -2
  34. package/dist/components/settings/taxAccountDrawerConfig.d.ts +0 -4
  35. package/dist/components/tax-forms/states/virginia/VA16Form.d.ts +53 -0
  36. package/dist/components/tax-forms/states/virginia/VA16Form.preview.d.ts +2 -0
  37. package/dist/components/ui/ToastProvider.d.ts +2 -2
  38. package/dist/embedded/EmbeddedContext.d.ts +4 -1
  39. package/dist/embedded/EmbeddedWidgetBase.d.ts +3 -1
  40. package/dist/embedded/TaxRemittanceEmbedded.d.ts +6 -0
  41. package/dist/embedded/pages/EmbeddedEntityEditPage.d.ts +6 -0
  42. package/dist/index.cjs +22 -22
  43. package/dist/index.cjs.map +1 -1
  44. package/dist/index.d.ts +2 -0
  45. package/dist/index.mjs +8240 -7750
  46. package/dist/index.mjs.map +1 -1
  47. package/dist/lib/entityFormUtils.d.ts +19 -7
  48. package/dist/lib/fieldRules.d.ts +92 -0
  49. package/dist/lib/fieldSchemas.d.ts +12 -0
  50. package/dist/lib/jwt.d.ts +10 -0
  51. package/dist/lib/paymentFrequency.d.ts +10 -0
  52. package/dist/lib/paymentStatus.d.ts +7 -0
  53. package/dist/lib/paymentsNavigation.d.ts +12 -0
  54. package/dist/lib/useElementWidth.d.ts +9 -0
  55. package/dist/pages/FederalPaymentReviewPage.d.ts +1 -0
  56. package/dist/styles.css +1 -1
  57. package/dist/types/bankAccount.d.ts +2 -0
  58. package/dist/types/createBankAccount.d.ts +2 -0
  59. package/dist/types/dashboard.d.ts +59 -0
  60. package/dist/types/entity.d.ts +3 -2
  61. package/dist/types/taxAccountDetails.d.ts +31 -29
  62. package/package.json +1 -1
  63. package/dist/components/dashboard/MonthlyOverviewSection.d.ts +0 -8
  64. package/dist/components/dashboard/MyPaymentsTable.d.ts +0 -8
  65. package/dist/components/dashboard/PaymentSummaryCard.d.ts +0 -21
  66. package/dist/components/settings/AddTaxAccountForm.d.ts +0 -32
  67. package/dist/components/settings/EditEntityModal.d.ts +0 -8
  68. package/dist/components/settings/taxAccountFormConfig.d.ts +0 -18
  69. package/dist/pages/AddTaxAccountPage.d.ts +0 -1
  70. package/dist/types/taxAccount.d.ts +0 -9
@@ -0,0 +1,53 @@
1
+ export interface AmountParts {
2
+ dollars: string;
3
+ cents: string;
4
+ }
5
+ /** Filled in from the state payment — displayed, never edited here. */
6
+ export interface VA16BoundData {
7
+ /** Printed top-right, e.g. `316`. */
8
+ docId: string;
9
+ /** Quarter end, as printed: `03 / 31 / 2026`. */
10
+ period: string;
11
+ dueDate: string;
12
+ /** The OCR line across the middle of the return. */
13
+ scanLine: string;
14
+ accountNumber: string;
15
+ fein: string;
16
+ name: string;
17
+ address: string;
18
+ city: string;
19
+ state: string;
20
+ zipCode: string;
21
+ /** Line 1 — the payment's withheld tax. */
22
+ incomeTaxWithheld: AmountParts;
23
+ }
24
+ /** Money lines 2–9, which the taxpayer completes. */
25
+ export interface VA16EditableAmounts {
26
+ previousPeriodAdjustments: AmountParts;
27
+ adjustedTotal: AmountParts;
28
+ paymentsMadeThisPeriod: AmountParts;
29
+ balanceOfTaxDue: AmountParts;
30
+ penalty: AmountParts;
31
+ interest: AmountParts;
32
+ paymentForFollowingMonth: AmountParts;
33
+ totalAmountDue: AmountParts;
34
+ }
35
+ export interface VA16EditableValues extends VA16EditableAmounts {
36
+ signature: string;
37
+ signatureDate: string;
38
+ phoneNumber: string;
39
+ }
40
+ interface VA16FormProps {
41
+ data: VA16BoundData;
42
+ /** Starting entries — anything omitted starts blank. */
43
+ initialValues?: Partial<VA16EditableValues>;
44
+ /** Fires on every keystroke with the complete set of entries. */
45
+ onValuesChange?: (values: VA16EditableValues) => void;
46
+ /** Leaves the return. Omit to hide the Back button. */
47
+ onBack?: () => void;
48
+ /** Offered only once the return is in edit mode. */
49
+ onSubmit?: (values: VA16EditableValues) => void;
50
+ isSubmitting?: boolean;
51
+ }
52
+ export declare function VA16Form({ data, initialValues, onValuesChange, onBack, onSubmit, isSubmitting, }: VA16FormProps): import("react").JSX.Element;
53
+ export {};
@@ -0,0 +1,2 @@
1
+ import { VA16BoundData } from './VA16Form';
2
+ export declare const VA16_TEMPORARY_BOUND_DATA: VA16BoundData;
@@ -1,7 +1,7 @@
1
1
  import { ReactNode } from 'react';
2
2
  interface ToastContextValue {
3
- showSuccess: (title: string, message: string) => void;
4
- showError: (title: string, message: string) => void;
3
+ showSuccess: (title: string, message?: string) => void;
4
+ showError: (title: string, message?: string) => void;
5
5
  }
6
6
  export declare function ToastProvider({ children }: {
7
7
  children: ReactNode;
@@ -11,13 +11,16 @@ interface EmbeddedContextValue {
11
11
  refetchEntities: () => Promise<void>;
12
12
  enabledPayments: PaymentType[];
13
13
  onPaymentRequired?: (info: PaymentRequiredInfo) => void;
14
+ /** Display name of the signed-in user, read from the access token. */
15
+ userName?: string;
14
16
  }
15
17
  interface EmbeddedContextProviderProps {
16
18
  onOrganizationCreated?: (org: EntityDetailsResponse) => void;
17
19
  enabledPayments?: PaymentType[];
18
20
  onPaymentRequired?: (info: PaymentRequiredInfo) => void;
21
+ userName?: string;
19
22
  children: ReactNode;
20
23
  }
21
- export declare function EmbeddedContextProvider({ onOrganizationCreated, enabledPayments, onPaymentRequired, children, }: EmbeddedContextProviderProps): import("react").JSX.Element;
24
+ export declare function EmbeddedContextProvider({ onOrganizationCreated, enabledPayments, onPaymentRequired, userName, children, }: EmbeddedContextProviderProps): import("react").JSX.Element;
22
25
  export declare function useEmbeddedContext(): EmbeddedContextValue;
23
26
  export {};
@@ -17,6 +17,8 @@ export interface EmbeddedWidgetBaseProps {
17
17
  selectEntityFnRef: MutableRefObject<((id: number) => void) | null>;
18
18
  /** Payment types this widget instance supports. Controls which dashboard action cards appear. */
19
19
  enabledPayments?: PaymentType[];
20
+ /** Display name of the signed-in user, used to greet them on the dashboard. */
21
+ userName?: string;
20
22
  /** The <Routes> subtree specific to this widget. */
21
23
  children: ReactNode;
22
24
  }
@@ -30,4 +32,4 @@ export interface EmbeddedWidgetBaseProps {
30
32
  *
31
33
  * Children should be a <Routes> element with the widget-specific route tree.
32
34
  */
33
- export declare function EmbeddedWidgetBase({ appKey, accessToken, apiBaseUrl, theme, onSessionExpired, onOrganizationCreated, onNavigate, onPaymentRequired, navigateFnRef, selectEntityFnRef, enabledPayments, children, }: EmbeddedWidgetBaseProps): import("react").JSX.Element;
35
+ export declare function EmbeddedWidgetBase({ appKey, accessToken, apiBaseUrl, theme, onSessionExpired, onOrganizationCreated, onNavigate, onPaymentRequired, navigateFnRef, selectEntityFnRef, enabledPayments, userName, children, }: EmbeddedWidgetBaseProps): import("react").JSX.Element;
@@ -56,6 +56,12 @@ export interface TaxRemittanceEmbeddedProps {
56
56
  apiBaseUrl: string;
57
57
  /** Optional visual theme overrides. */
58
58
  theme?: TaxRemittanceTheme;
59
+ /**
60
+ * Optional override for the dashboard greeting ("Welcome, Jane!").
61
+ * By default the widget reads the name from the access token's claims,
62
+ * so hosts don't need to pass this.
63
+ */
64
+ userName?: string;
59
65
  /**
60
66
  * Called when the user's session expires (401/403 from the API).
61
67
  * Use this to redirect to your own login page.
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Full-page Edit Entity screen — the same shell as the Add Entity page
3
+ * (EmbeddedEntityFormPage), so both flows read identically.
4
+ * Top-left Back returns to the entity list (or state.from).
5
+ */
6
+ export declare function EmbeddedEntityEditPage(): import("react").JSX.Element;