@npm-zenwork/tax-remittance-ui 0.5.2 → 0.6.0

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

@@ -19,11 +19,7 @@ export interface PaymentCategorySummary {
     failed: number;
     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.
- */
+/** Currency with cents always shown - `$12,450.00`, never `$12,450`. */
 export declare function formatDashboardAmount(amount: number): string;
 export interface TaxYearOption {
     /** The year sent to the charts endpoint. */

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

@@ -0,0 +1,13 @@
+interface EntityQuickActionsProps {
+    entityCount: number;
+    /** Where Add Entity returns to on Cancel — the page holding these buttons. */
+    from: string;
+}
+/**
+ * The `Entities (n)` / `Add Entity` pair. It leads the dashboard once the
+ * account has entities, and stands in for the payment CTAs on the payments page
+ * while it has none — there is nothing to file a payment against until an
+ * entity exists, so that is the action to offer.
+ */
+export declare function EntityQuickActions({ entityCount, from }: EntityQuickActionsProps): import("react").JSX.Element;
+export {};

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

@@ -1,5 +1,6 @@
 import { FieldErrors, UseFormRegister, UseFormRegisterReturn } from 'react-hook-form';
 import { EntityFormValues } from '../../types/entity';
+import { HelpKey } from './entityHelpContent';
 interface EntityPrimaryTaxpayerFieldsProps {
     register: UseFormRegister<EntityFormValues>;
     errors: FieldErrors<EntityFormValues>;
@@ -9,8 +10,8 @@ interface EntityPrimaryTaxpayerFieldsProps {
     idLabel: string;
     idPlaceholder: string;
     idMaxLength: number;
-    resetHelp: () => void;
+    focusHelp: (key: HelpKey) => () => void;
 }
 /** Individual account fields: the primary taxpayer's name, SSN and contact details. */
-export declare function EntityPrimaryTaxpayerFields({ register, errors, einRegister, phoneRegister, accountType, idLabel, idPlaceholder, idMaxLength, resetHelp, }: EntityPrimaryTaxpayerFieldsProps): import("react").JSX.Element;
+export declare function EntityPrimaryTaxpayerFields({ register, errors, einRegister, phoneRegister, accountType, idLabel, idPlaceholder, idMaxLength, focusHelp, }: EntityPrimaryTaxpayerFieldsProps): import("react").JSX.Element;
 export {};

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

@@ -22,6 +22,22 @@ export declare const HELP_CONTENT: {
         correct: string;
         mistake: string;
     };
+    firstName: {
+        title: string;
+        required: true;
+        description: string;
+        tips: string[];
+        correct: string;
+        mistake: string;
+    };
+    lastName: {
+        title: string;
+        required: true;
+        description: string;
+        tips: string[];
+        correct: string;
+        mistake: string;
+    };
     legalBusinessName: {
         title: string;
         required: true;
@@ -70,6 +86,14 @@ export declare const HELP_CONTENT: {
         correct: string;
         mistake: string;
     };
+    ssn: {
+        title: string;
+        required: true;
+        description: import("react").JSX.Element;
+        tips: string[];
+        correct: string;
+        mistake: string;
+    };
     address1: {
         title: string;
         required: true;

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

@@ -0,0 +1,17 @@
+import { StatePaymentStateOption } from '../../types/statePayment';
+/**
+ * The jurisdiction column reads as the plain state name — `California`, per the
+ * Figma — while the API labels state rows with a bracketed qualifier and, in
+ * some payloads, the code alone (`CA (State)`). This drops that bracket and
+ * resolves a code to its full name.
+ *
+ * Only those two shapes are touched: a label that is already a name, or an
+ * agency name of its own (`IRS - Federal`, `New York DTF`), is left exactly as
+ * the API sent it.
+ */
+export declare function formatJurisdictionLabel(raw: string, states: StatePaymentStateOption[]): string;
+/**
+ * Formatter for jurisdiction labels, backed by the state list the payment form
+ * already caches — no extra request on the dashboard or payments table.
+ */
+export declare function useJurisdictionLabel(): (raw: string) => string;

package/dist/embedded/ThemeProvider.d.ts

@@ -30,6 +30,22 @@ interface ThemeProviderProps {
     theme?: TaxRemittanceTheme;
     children: ReactNode;
 }
+/**
+ * The element modals, drawers, dropdowns and toasts must portal into.
+ *
+ * Do not portal to `document.body` directly. Every rule this package ships is scoped
+ * under `.tax-remittance-embedded` so it cannot leak into the host application, which
+ * means anything mounted outside that subtree receives none of it — a modal portaled
+ * to `document.body` renders as an unstyled static block at the end of the page, with
+ * no positioning, backdrop or z-index, and is effectively invisible.
+ *
+ * This root is a body-level sibling carrying the widget class and the theme variables,
+ * so portalled content is styled correctly while still escaping the host's overflow
+ * and stacking contexts the way `document.body` did.
+ *
+ * Always returns an element, so callers can hand it straight to `createPortal`.
+ */
+export declare function usePortalRoot(): HTMLElement;
 /**
  * Injects the client's brand colors as CSS custom properties on the
  * `.tax-remittance-embedded` wrapper div.
@@ -42,6 +58,8 @@ interface ThemeProviderProps {
  * `index.css` maps Tailwind's `--color-brand-*` tokens to these vars
  * inside the `.tax-remittance-embedded` scope, so shared components
  * like `<Button>` and `<Input>` automatically respect client themes.
+ *
+ * It also owns the portal root — see `usePortalRoot`.
  */
 export declare function ThemeProvider({ theme, children }: ThemeProviderProps): import("react").JSX.Element;
 export {};