@npm-zenwork/tax-remittance-ui 0.1.15 → 0.2.0

package/dist/api/reference.d.ts

@@ -0,0 +1,14 @@
+export interface ZipRange {
+    from: number;
+    to: number;
+}
+export interface StateOption {
+    code: string;
+    name: string;
+    /** 3-digit ZIP prefix ranges (US only — empty for Canada). */
+    zipRanges: ZipRange[];
+}
+/** States/provinces for a country — `country` accepts "United States" or "Canada".
+ *  US entries carry their ZIP prefix ranges so the caller can validate ZIP-vs-state
+ *  locally without another request. */
+export declare function getStates(country: string): Promise<StateOption[]>;

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

@@ -0,0 +1,17 @@
+import { ReactNode } from 'react';
+interface FormCardProps {
+    title: string;
+    subtitle?: string;
+    step?: number;
+    children: ReactNode;
+    className?: string;
+}
+/**
+ * Bordered card with a title/subtitle header — separates a form into named
+ * sections (e.g. Basic Information vs. Address Information) instead of one
+ * long field list. Matches the settings module's SettingsCard visual
+ * language (border, radius, heading hierarchy) so the two don't diverge.
+ * An optional numbered `step` badge helps orient multi-section forms.
+ */
+export declare function FormCard({ title, subtitle, step, children, className }: FormCardProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,16 @@
+import { InputHTMLAttributes, SelectHTMLAttributes } 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.
+ */
+export declare function PhoneInputGroup({ label, required, error, countryCodeSelectProps, phoneInputProps, }: PhoneInputGroupProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,22 @@
+import { ReactNode } from 'react';
+export interface SegmentedControlOption<T extends string> {
+    label: string;
+    value: T;
+    icon?: ReactNode;
+}
+interface SegmentedControlProps<T extends string> {
+    label: string;
+    required?: boolean;
+    options: SegmentedControlOption<T>[];
+    value: T;
+    onChange: (value: T) => 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.
+ */
+export declare function SegmentedControl<T extends string>({ label, required, options, value, onChange, }: SegmentedControlProps<T>): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,17 @@
+interface StickyActionFooterProps {
+    onCancel: () => void;
+    isSubmitting: boolean;
+    submitLabel: string;
+    submittingLabel: string;
+    cancelLabel?: string;
+    className?: string;
+}
+/**
+ * Cancel / submit action row, pinned to the bottom of its scroll container.
+ * `position: sticky` keeps it in normal document flow (so it never covers
+ * content permanently) while staying visible once the page/modal is scrolled
+ * past it. Works for both a full page scroll (Create Entity) and a modal
+ * whose footer already sits outside its own scrollable content area (Edit).
+ */
+export declare function StickyActionFooter({ onCancel, isSubmitting, submitLabel, submittingLabel, cancelLabel, className, }: StickyActionFooterProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,14 @@
+import { ReactNode } from 'react';
+interface SettingsCardProps {
+    title: string;
+    subtitle?: string;
+    children: ReactNode;
+    className?: string;
+}
+/**
+ * Bordered card used to separate a settings form into named sections (e.g.
+ * Common Information vs. a state's own tax registration fields) instead of
+ * one long field list. Generic — no client-specific styling.
+ */
+export declare function SettingsCard({ title, subtitle, children, className }: SettingsCardProps): import("react").JSX.Element;
+export {};

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

@@ -1,44 +1,18 @@
 export declare const virginiaCities: readonly ["Alexandria", "Arlington", "Chesapeake", "Hampton", "Lynchburg", "Newport News", "Norfolk", "Richmond", "Roanoke", "Virginia Beach"];
-export declare const taxAccountStates: {
-    code: string;
-    name: string;
-}[];
-export declare const virginiaSpecificFields: readonly [{
-    readonly name: "virginiaTaxAccountId";
-    readonly label: "Virginia Tax Account ID";
-    readonly required: true;
-}, {
-    readonly name: "virginiaWithholdingAccountingId";
-    readonly label: "Virginia Withholding Accounting ID";
-    readonly required: true;
-}, {
-    readonly name: "unemploymentTaxAccountId";
-    readonly label: "Unemployment Tax Account ID";
-    readonly required: true;
-}, {
-    readonly name: "virginiaDepartmentOfTaxationClientNumber";
-    readonly label: "Virginia Department of Taxation Client Number";
-    readonly required: true;
-}, {
-    readonly name: "businessLocationCode";
-    readonly label: "Business Location Code";
-    readonly required: true;
-}, {
-    readonly name: "franchiseTaxAccount";
-    readonly label: "Franchise Tax Account";
-    readonly required: true;
-}, {
-    readonly name: "transientOccupancyTaxAccountId";
-    readonly label: "Transient Occupancy Tax Account ID";
-    readonly required: false;
-}, {
-    readonly name: "certificateOfAuthorityNumber";
-    readonly label: "Certificate of Authority Number (Foreign Entities)";
-    readonly required: false;
-}];
-export declare const virginiaFullWidthFields: readonly [{
-    readonly name: "licensedProfessionalEmployerEntityNumber";
-    readonly label: "Licensed Professional Employer (POE) Entity Number";
-    readonly required: false;
-}];
-export type VirginiaSpecificFieldName = (typeof virginiaSpecificFields)[number]['name'] | (typeof virginiaFullWidthFields)[number]['name'];
+export type TaxAccountFieldName = 'virginiaTaxAccountId' | 'virginiaWithholdingAccountingId' | 'unemploymentTaxAccountId' | 'virginiaDepartmentOfTaxationClientNumber' | 'businessLocationCode' | 'franchiseTaxAccount' | 'transientOccupancyTaxAccountId' | 'certificateOfAuthorityNumber' | 'licensedProfessionalEmployerEntityNumber';
+export interface TaxAccountFieldDef {
+    name: TaxAccountFieldName;
+    label: string;
+    required: boolean;
+    placeholder?: string;
+}
+export interface TaxAccountFieldGroup {
+    title: string;
+    fields: TaxAccountFieldDef[];
+}
+/**
+ * State-specific field sections, keyed by state code. A state with no entry
+ * here has no state-specific card rendered — supporting a new state is adding
+ * a key here, never a change to the form's rendering components.
+ */
+export declare const STATE_TAX_FIELD_GROUPS: Partial<Record<string, TaxAccountFieldGroup[]>>;