@npm-zenwork/tax-remittance-ui 0.12.0 → 0.12.2

package/dist/components/tax-forms/states/maryland/MD500DForm.d.ts

@@ -0,0 +1,50 @@
+import { StateFormSubmitResponse } from '../../../../api/stateForms';
+/**
+ * Ids the backend issues once a record exists, sent back on submit so it
+ * updates that record. Absent (`null`) for a new voucher. Never shown.
+ */
+export interface MD500DBoundData {
+    payerDetailId?: number | null;
+    formRecordId?: number | null;
+    statePayrollFormId?: number | null;
+}
+export interface MD500DEditableValues {
+    /** The chosen Dashboard business entity. `null` until one is chosen. */
+    payerId: number | null;
+    fein: string;
+    name: string;
+    address1: string;
+    address2: string;
+    city: string;
+    state: string;
+    /** `12345` or `12345-6789`. */
+    zipCode: string;
+    /** MM/DD/YYYY in 2026 — blank for a calendar year. */
+    fiscalYearBeginning: string;
+    /** MM/DD/YYYY — blank for a calendar year. */
+    fiscalYearEnding: string;
+    foreignCountry: string;
+    foreignProvince: string;
+    foreignPostalCode: string;
+    /** "Check here if you are a first time filer or your name has changed." */
+    firstTimeOrNameChange: boolean;
+    /** `'1'`–`'4'`, `''` until chosen. */
+    installment: string;
+    /** Estimated tax paid with this declaration — whole dollars, digits only. */
+    amount: string;
+}
+interface MD500DFormProps {
+    data: MD500DBoundData;
+    /** Starting entries — anything omitted starts blank. */
+    initialValues?: Partial<MD500DEditableValues>;
+    /** Fires on every change with the complete set of entries. */
+    onValuesChange?: (values: MD500DEditableValues) => void;
+    /** Leaves the form. Omit to hide the Back button. */
+    onBack?: () => void;
+    /** Fires after a successful submit, with the API's response. */
+    onSubmitted?: (response: StateFormSubmitResponse) => void;
+    /** Estimated/Income Tax forms are view + download-PDF only; see `useStateTaxForm`'s `readOnly` option. */
+    readOnly?: boolean;
+}
+export declare function MD500DForm({ data, initialValues, onValuesChange, onBack, onSubmitted, readOnly }: MD500DFormProps): import("react").JSX.Element;
+export {};

package/dist/components/tax-forms/states/maryland/MD500DForm.payload.d.ts

@@ -0,0 +1,51 @@
+import { AutoFillJson } from '../autoFill';
+import { MD500DBoundData, MD500DEditableValues } from './MD500DForm';
+export interface MD500DSubmitPayload {
+    formCode: '500D';
+    state: 'MD';
+    /** The chosen Dashboard entity — a business. */
+    payerId: number;
+    /** Hidden ids the backend issues for an existing record; `null` on a new one. */
+    ids: {
+        payerDetailId: number | null;
+        formRecordId: number | null;
+        statePayrollFormId: number | null;
+    };
+    taxYear: number;
+    /** `MM/DD/YYYY` dates of a fiscal year; `null` for a calendar year. */
+    fiscalYear: {
+        beginning: string;
+        ending: string;
+    } | null;
+    fein: string;
+    corporation: {
+        name: string;
+    };
+    address: {
+        line1: string;
+        line2: string | null;
+        city: string;
+        state: string;
+        zipCode: string;
+        foreignCountry: string | null;
+        foreignProvince: string | null;
+        foreignPostalCode: string | null;
+    };
+    /** "Check here if you are a first time filer or your name has changed." */
+    firstTimeOrNameChange: boolean;
+    /** 1–4. */
+    installment: number;
+    /** `MM/DD/YYYY` — the 15th of the 4th, 6th, 9th or 12th month of the tax year. */
+    dueDate: string;
+    /** Estimated tax paid with this declaration — whole dollars. */
+    amount: number;
+}
+export declare function buildMD500DPayload(data: MD500DBoundData, values: MD500DEditableValues): MD500DSubmitPayload;
+export type { AutoFillJson };
+/**
+ * Maps the backend's canonical auto-fill shape (see `autoFill.ts`) onto
+ * 500D's own values, formatted as `corporationFieldsFromEntity` does. The
+ * record carries no fiscal year, foreign address or first-time-filer answer,
+ * so those stay blank / unchecked (a calendar year).
+ */
+export declare function fieldsFromAutoFillJson(autoFill: AutoFillJson): Partial<MD500DEditableValues>;

package/dist/components/tax-forms/states/maryland/MD500DForm.schema.d.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export declare const md500DSchema: z.ZodObject<{
+    payerId: z.ZodNullable<z.ZodNumber>;
+    fein: z.ZodString;
+    name: z.ZodString;
+    address1: z.ZodString;
+    address2: z.ZodString;
+    city: z.ZodString;
+    state: z.ZodString;
+    zipCode: z.ZodString;
+    fiscalYearBeginning: z.ZodString;
+    fiscalYearEnding: z.ZodString;
+    foreignCountry: z.ZodString;
+    foreignProvince: z.ZodString;
+    foreignPostalCode: z.ZodString;
+    firstTimeOrNameChange: z.ZodBoolean;
+    installment: z.ZodString;
+    amount: z.ZodString;
+}, z.core.$strip>;

package/dist/components/tax-forms/states/maryland/MD510DForm.d.ts

@@ -0,0 +1,54 @@
+import { StateFormSubmitResponse } from '../../../../api/stateForms';
+/**
+ * Ids the backend issues once a record exists, sent back on submit so it
+ * updates that record. Absent (`null`) for a new voucher. Never shown.
+ */
+export interface MD510DBoundData {
+    payerDetailId?: number | null;
+    formRecordId?: number | null;
+    statePayrollFormId?: number | null;
+}
+export interface MD510DEditableValues {
+    /** The chosen Dashboard business entity. `null` until one is chosen. */
+    payerId: number | null;
+    fein: string;
+    name: string;
+    address1: string;
+    address2: string;
+    city: string;
+    state: string;
+    /** `12345` or `12345-6789`. */
+    zipCode: string;
+    /** MM/DD/YYYY in 2026 — blank for a calendar year. */
+    fiscalYearBeginning: string;
+    /** MM/DD/YYYY — blank for a calendar year. */
+    fiscalYearEnding: string;
+    foreignCountry: string;
+    foreignProvince: string;
+    foreignPostalCode: string;
+    /** One of `ENTITY_TYPES` — pre-selected from the entity type when it maps to one, `''` otherwise. */
+    entityType: string;
+    /** "Check here if you are a first time filer or your mailing address has changed." */
+    firstTimeOrAddressChange: boolean;
+    /** `'A'` (all members' shares) or `'B'` (nonresident members only), `''` until chosen. */
+    electionBox: string;
+    /** `'1'`–`'4'`, `''` until chosen. */
+    installment: string;
+    /** Estimated tax paid with this declaration — whole dollars, digits only. */
+    amount: string;
+}
+interface MD510DFormProps {
+    data: MD510DBoundData;
+    /** Starting entries — anything omitted starts blank. */
+    initialValues?: Partial<MD510DEditableValues>;
+    /** Fires on every change with the complete set of entries. */
+    onValuesChange?: (values: MD510DEditableValues) => void;
+    /** Leaves the form. Omit to hide the Back button. */
+    onBack?: () => void;
+    /** Fires after a successful submit, with the API's response. */
+    onSubmitted?: (response: StateFormSubmitResponse) => void;
+    /** Estimated/Income Tax forms are view + download-PDF only; see `useStateTaxForm`'s `readOnly` option. */
+    readOnly?: boolean;
+}
+export declare function MD510DForm({ data, initialValues, onValuesChange, onBack, onSubmitted, readOnly }: MD510DFormProps): import("react").JSX.Element;
+export {};

package/dist/components/tax-forms/states/maryland/MD510DForm.payload.d.ts

@@ -0,0 +1,56 @@
+import { AutoFillJson } from '../autoFill';
+import { MD510DBoundData, MD510DEditableValues } from './MD510DForm';
+import { MD510DEntityType } from './MD510DForm.schema';
+export interface MD510DSubmitPayload {
+    formCode: '510D';
+    state: 'MD';
+    /** The chosen Dashboard entity — a business. */
+    payerId: number;
+    /** Hidden ids the backend issues for an existing record; `null` on a new one. */
+    ids: {
+        payerDetailId: number | null;
+        formRecordId: number | null;
+        statePayrollFormId: number | null;
+    };
+    taxYear: number;
+    /** `MM/DD/YYYY` dates of a fiscal year; `null` for a calendar year. */
+    fiscalYear: {
+        beginning: string;
+        ending: string;
+    } | null;
+    fein: string;
+    entity: {
+        name: string;
+        type: MD510DEntityType;
+    };
+    address: {
+        line1: string;
+        line2: string | null;
+        city: string;
+        state: string;
+        zipCode: string;
+        foreignCountry: string | null;
+        foreignProvince: string | null;
+        foreignPostalCode: string | null;
+    };
+    /** "Check here if you are a first time filer or your mailing address has changed." */
+    firstTimeOrAddressChange: boolean;
+    /** `'A'` — elected to remit tax on all members' shares (Form 511); `'B'` — nonresident members only (Form 510). */
+    electionBox: 'A' | 'B';
+    /** 1–4. */
+    installment: number;
+    /** `MM/DD/YYYY` — the 15th of the 4th, 6th, 9th and 12th (S corporations) or 13th month of the tax year. */
+    dueDate: string;
+    /** Estimated tax paid with this declaration — whole dollars. */
+    amount: number;
+}
+export declare function buildMD510DPayload(data: MD510DBoundData, values: MD510DEditableValues): MD510DSubmitPayload;
+export type { AutoFillJson };
+/**
+ * Maps the backend's canonical auto-fill shape (see `autoFill.ts`) onto
+ * 510/511D's own values, formatted as `passThroughFieldsFromEntity` does —
+ * the type of entity is pre-selected only when the entity type maps to a box.
+ * The record carries no Box A / Box B election, fiscal year, foreign address
+ * or first-time-filer answer, so those stay blank / unchecked.
+ */
+export declare function fieldsFromAutoFillJson(autoFill: AutoFillJson): Partial<MD510DEditableValues>;

package/dist/components/tax-forms/states/maryland/MD510DForm.schema.d.ts

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+/** "TYPE OF ENTITY - Check the applicable box." */
+export declare const ENTITY_TYPES: readonly [{
+    readonly value: "S_CORPORATION";
+    readonly label: "S Corporation";
+}, {
+    readonly value: "PARTNERSHIP";
+    readonly label: "Partnership";
+}, {
+    readonly value: "LLC";
+    readonly label: "Limited Liability Company";
+}, {
+    readonly value: "BUSINESS_TRUST";
+    readonly label: "Business Trust";
+}];
+export type MD510DEntityType = (typeof ENTITY_TYPES)[number]['value'];
+/** Box A — all members' shares (Form 511); Box B — nonresident members only (Form 510). */
+export declare const ELECTION_BOXES: readonly ["A", "B"];
+export declare const md510DSchema: z.ZodObject<{
+    payerId: z.ZodNullable<z.ZodNumber>;
+    fein: z.ZodString;
+    name: z.ZodString;
+    address1: z.ZodString;
+    address2: z.ZodString;
+    city: z.ZodString;
+    state: z.ZodString;
+    zipCode: z.ZodString;
+    fiscalYearBeginning: z.ZodString;
+    fiscalYearEnding: z.ZodString;
+    foreignCountry: z.ZodString;
+    foreignProvince: z.ZodString;
+    foreignPostalCode: z.ZodString;
+    entityType: z.ZodString;
+    firstTimeOrAddressChange: z.ZodBoolean;
+    electionBox: z.ZodString;
+    installment: z.ZodString;
+    amount: z.ZodString;
+}, z.core.$strip>;

package/dist/components/tax-forms/states/maryland/MDEstimated.shared.d.ts

@@ -0,0 +1,55 @@
+/** The tax year this edition of the vouchers is filled for. */
+export declare const FORM_TAX_YEAR = 2026;
+/** Both vouchers take whole dollars only. */
+export declare const AMOUNT_MAX_DIGITS = 10;
+export declare const FOREIGN_COUNTRY_MAX_LENGTH = 35;
+export declare const FOREIGN_PROVINCE_MAX_LENGTH = 35;
+export declare const FOREIGN_POSTAL_CODE_MAX_LENGTH = 16;
+/** Whole dollars as a number — blank counts as 0. */
+export declare const dollarsOf: (value: string) => number;
+/** `MM/DD/YYYY`. */
+export declare const formatDate: (date: Date) => string;
+export declare const INSTALLMENTS: readonly ["1", "2", "3", "4"];
+/** The first day of the tax year: the fiscal year beginning when it's a real 2026 date, January 1 otherwise. */
+export declare function taxYearStart(fiscalYearBeginning: string): Date;
+/**
+ * The four due dates, installment 1 first — the 15th day of the 4th, 6th,
+ * 9th and `lastMonth`th month following the beginning of the tax year
+ * (`12`, or `13` for 510/511D's partnerships, LLCs and business trusts).
+ */
+export declare function installmentDueDates(fiscalYearBeginning: string, lastMonth?: 12 | 13): Date[];
+/** What both vouchers print the same way, as their schemas see it. */
+interface SharedVoucherValues {
+    payerId: number | null;
+    fein: string;
+    name: string;
+    address1: string;
+    city: string;
+    state: string;
+    zipCode: string;
+    fiscalYearBeginning: string;
+    fiscalYearEnding: string;
+    foreignCountry: string;
+    foreignProvince: string;
+    foreignPostalCode: string;
+    installment: string;
+    amount: string;
+}
+type Check = (path: (string | number)[], ok: boolean, message: string) => void;
+/**
+ * The rules both vouchers share:
+ *   - the business is the chosen *business* entity — a gap means the entity
+ *     needs editing;
+ *   - "or fiscal year beginning … 2026, ending …": blank for a calendar year;
+ *     otherwise both dates, beginning in 2026 and ending after it, no more
+ *     than 12 months later (a short period may end sooner);
+ *   - the foreign address boxes are optional;
+ *   - the installment (1–4) and the amount paid in whole dollars, more than $0.
+ */
+export declare function checkSharedVoucher(values: SharedVoucherValues, check: Check): void;
+/** `123456789` / `12345-6789` -> `{ zip, plusFour }`, as 510/511D prints them in two boxes. */
+export declare function splitZip(zipCode: string): {
+    zip: string;
+    plusFour: string;
+};
+export {};

package/dist/components/tax-forms/states/maryland/MDEstimatedParts.d.ts

@@ -0,0 +1,8 @@
+/** `Maryland Form 500D │ Corporation Declaration of Estimated Income Tax │ 2026`. */
+export declare function MDVoucherHeader({ formNumber, title, revision }: {
+    formNumber: string;
+    title: [string, string];
+    revision: string;
+}): import("react").JSX.Element;
+/** The payable-to / mail-to text under the voucher. */
+export declare function MDMailTo(): import("react").JSX.Element;

package/dist/components/tax-forms/states/maryland/MDPVForm.d.ts

@@ -0,0 +1,50 @@
+import { StateFormSubmitResponse } from '../../../../api/stateForms';
+import { AmountParts } from '../../../../lib/fieldRules';
+/**
+ * Ids the backend issues once a record exists, sent back on submit so it
+ * updates that record. Absent (`null`) for a new voucher. Never shown.
+ */
+export interface MDPVBoundData {
+    payerDetailId?: number | null;
+    formRecordId?: number | null;
+    statePayrollFormId?: number | null;
+}
+export interface MDPVEditableValues {
+    /** The bound Dashboard individual entity. */
+    payerId: number | null;
+    /** Which of the four installments, `'1'`–`'4'` — from the payment's quarter. */
+    voucher: string;
+    ssn: string;
+    firstName: string;
+    lastName: string;
+    address1: string;
+    address2: string;
+    city: string;
+    state: string;
+    /** `12345` or `12345-6789`. */
+    zipCode: string;
+    middleInitial: string;
+    spouseSsn: string;
+    spouseFirstName: string;
+    spouseMiddleInitial: string;
+    spouseLastName: string;
+    /** Box 1a — first-time estimated filer or change in filing status. */
+    firstTimeOrFilingStatusChange: boolean;
+    /** Payment amount — dollars and cents. */
+    amount: AmountParts;
+}
+interface MDPVFormProps {
+    data: MDPVBoundData;
+    /** Starting entries — anything omitted starts blank. */
+    initialValues?: Partial<MDPVEditableValues>;
+    /** Fires on every change with the complete set of entries. */
+    onValuesChange?: (values: MDPVEditableValues) => void;
+    /** Leaves the form. Omit to hide the Back button. */
+    onBack?: () => void;
+    /** Fires after a successful submit, with the API's response. */
+    onSubmitted?: (response: StateFormSubmitResponse) => void;
+    /** Estimated/Income Tax forms are view + download-PDF only; see `useStateTaxForm`'s `readOnly` option. */
+    readOnly?: boolean;
+}
+export declare function MDPVForm({ data, initialValues, onValuesChange, onBack, onSubmitted, readOnly }: MDPVFormProps): import("react").JSX.Element;
+export {};

package/dist/components/tax-forms/states/maryland/MDPVForm.payload.d.ts

@@ -0,0 +1,52 @@
+import { AutoFillJson } from '../autoFill';
+import { MDPVBoundData, MDPVEditableValues } from './MDPVForm';
+export interface MDPVSubmitPayload {
+    formCode: 'PV';
+    state: 'MD';
+    /** The bound Dashboard entity — an individual. */
+    payerId: number;
+    /** Hidden ids the backend issues for an existing record; `null` on a new one. */
+    ids: {
+        payerDetailId: number | null;
+        formRecordId: number | null;
+        statePayrollFormId: number | null;
+    };
+    taxYear: number;
+    /** Box 1 — always the estimated payment. */
+    paymentType: '502D';
+    /** Box 1a. */
+    firstTimeOrFilingStatusChange: boolean;
+    /** Which of the four installments, 1–4. */
+    voucher: number;
+    /** The installment's due date, `MM/DD/YYYY`. */
+    dueDate: string;
+    primary: {
+        firstName: string;
+        middleInitial: string | null;
+        lastName: string;
+        ssn: string;
+    };
+    /** `null` without a joint-return spouse. */
+    spouse: {
+        firstName: string;
+        middleInitial: string | null;
+        lastName: string;
+        ssn: string;
+    } | null;
+    address: {
+        line1: string;
+        line2: string | null;
+        city: string;
+        state: string;
+        zipCode: string;
+    };
+    /** Dollars and cents. */
+    amount: number;
+}
+export declare function buildMDPVPayload(data: MDPVBoundData, values: MDPVEditableValues): MDPVSubmitPayload;
+export type { AutoFillJson };
+/**
+ * Maps the backend's canonical auto-fill shape (see `autoFill.ts`) onto MD PV's own values.
+ * Middle initials and box 1a have no equivalent and stay blank / unchecked.
+ */
+export declare function fieldsFromAutoFillJson(autoFill: AutoFillJson): Partial<MDPVEditableValues>;

package/dist/components/tax-forms/states/maryland/MDPVForm.schema.d.ts

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+/** The tax year this edition of the voucher is filled for — box 1's "Tax Year". */
+export declare const FORM_TAX_YEAR = 2026;
+export declare const NAME_MAX_LENGTH = 50;
+/** The payment type this form files — box 1 on the PV. */
+export declare const PAYMENT_TYPE = "502D";
+/**
+ * The PV prints no dates. These are the four 2026 calendar-year
+ * estimated-payment due dates from the Form 502D schedule (April 15, June 15
+ * and September 15 of the tax year, January 15 of the next).
+ */
+export declare const VOUCHERS: readonly [{
+    readonly value: "1";
+    readonly dueDate: "04/15/2026";
+}, {
+    readonly value: "2";
+    readonly dueDate: "06/15/2026";
+}, {
+    readonly value: "3";
+    readonly dueDate: "09/15/2026";
+}, {
+    readonly value: "4";
+    readonly dueDate: "01/15/2027";
+}];
+/** The PV's four payment-type boxes, in printed order. Only box 1 (502D) is filed by this form. */
+export declare const PAYMENT_TYPES: readonly [{
+    readonly box: "1";
+    readonly code: "502D";
+    readonly label: "Estimated Payment/Quarterly (502D)";
+}, {
+    readonly box: "2";
+    readonly code: "502E";
+    readonly label: "Extension Payment (502E)";
+}, {
+    readonly box: "3";
+    readonly code: "502";
+    readonly label: "Payment with resident return (502)";
+}, {
+    readonly box: "4";
+    readonly code: "505";
+    readonly label: "Payment with nonresident return (505)";
+}];
+export declare const mdPVSchema: z.ZodObject<{
+    payerId: z.ZodNullable<z.ZodNumber>;
+    voucher: z.ZodString;
+    ssn: z.ZodString;
+    firstName: z.ZodString;
+    middleInitial: z.ZodString;
+    lastName: z.ZodString;
+    spouseSsn: z.ZodString;
+    spouseFirstName: z.ZodString;
+    spouseMiddleInitial: z.ZodString;
+    spouseLastName: z.ZodString;
+    address1: z.ZodString;
+    address2: z.ZodString;
+    city: z.ZodString;
+    state: z.ZodString;
+    zipCode: z.ZodString;
+    firstTimeOrFilingStatusChange: z.ZodBoolean;
+    amount: z.ZodObject<{
+        dollars: z.ZodString;
+        cents: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;

package/dist/components/tax-forms/states/massachusetts/MA1ESForm.d.ts

@@ -0,0 +1,54 @@
+import { StateFormSubmitResponse } from '../../../../api/stateForms';
+import { AmountParts } from '../../../../lib/fieldRules';
+/**
+ * Ids the backend issues once a record exists, sent back on submit so it
+ * updates that record. Absent (`null`) for a new voucher. Never shown.
+ */
+export interface MA1ESBoundData {
+    payerDetailId?: number | null;
+    formRecordId?: number | null;
+    statePayrollFormId?: number | null;
+}
+export interface MA1ESEditableValues {
+    /** The chosen Dashboard individual entity. `null` until one is chosen. */
+    payerId: number | null;
+    /** Which of the four vouchers, `'1'`–`'4'`; `''` until chosen. */
+    voucher: string;
+    lastName: string;
+    firstName: string;
+    middleInitial: string;
+    ssn: string;
+    address: string;
+    city: string;
+    state: string;
+    /** `12345` or `12345-6789`. */
+    zipCode: string;
+    spouseFirstName: string;
+    spouseMiddleInitial: string;
+    email: string;
+    phone: string;
+    isFiscalYear: boolean;
+    /** MM/DD/YYYY — the fiscal year's last day; only for a fiscal year. */
+    fiscalFilingPeriod: string;
+    /** MM/DD/YYYY — this voucher's due date; only for a fiscal year. */
+    fiscalDueDate: string;
+    /** 1. Amount due with this installment — dollars and cents. */
+    amount: AmountParts;
+    /** Form you plan to file — `'form1'` or `'form1NRPY'`; `''` until chosen. */
+    returnForm: string;
+}
+interface MA1ESFormProps {
+    data: MA1ESBoundData;
+    /** Starting entries — anything omitted starts blank. */
+    initialValues?: Partial<MA1ESEditableValues>;
+    /** Fires on every change with the complete set of entries. */
+    onValuesChange?: (values: MA1ESEditableValues) => void;
+    /** Leaves the form. Omit to hide the Back button. */
+    onBack?: () => void;
+    /** Fires after a successful submit, with the API's response. */
+    onSubmitted?: (response: StateFormSubmitResponse) => void;
+    /** Estimated/Income Tax forms are view + download-PDF only; see `useStateTaxForm`'s `readOnly` option. */
+    readOnly?: boolean;
+}
+export declare function MA1ESForm({ data, initialValues, onValuesChange, onBack, onSubmitted, readOnly }: MA1ESFormProps): import("react").JSX.Element;
+export {};

package/dist/components/tax-forms/states/massachusetts/MA1ESForm.payload.d.ts

@@ -0,0 +1,58 @@
+import { AutoFillJson } from '../autoFill';
+import { MA1ESBoundData, MA1ESEditableValues } from './MA1ESForm';
+export interface MA1ESSubmitPayload {
+    formCode: '1-ES';
+    state: 'MA';
+    /** The chosen Dashboard entity — an individual. */
+    payerId: number;
+    /** Hidden ids the backend issues for an existing record; `null` on a new one. */
+    ids: {
+        payerDetailId: number | null;
+        formRecordId: number | null;
+        statePayrollFormId: number | null;
+    };
+    taxYear: number;
+    /** Which of the four vouchers, 1–4. */
+    voucher: number;
+    /** The last day of the tax year, `MM/DD/YYYY` — `12/31` for a calendar year. */
+    taxFilingPeriod: string;
+    /** `MM/DD/YYYY` — the schedule's date, or the fiscal-year filer's own. */
+    dueDate: string;
+    isFiscalYear: boolean;
+    /** The codes DOR pre-prints on the voucher. */
+    taxType: string;
+    voucherType: string;
+    idType: string;
+    vendorCode: string;
+    taxpayer: {
+        ssn: string;
+        lastName: string;
+        firstName: string;
+        middleInitial: string | null;
+    };
+    /** `null` unless it's a joint payment. */
+    spouse: {
+        firstName: string;
+        middleInitial: string | null;
+    } | null;
+    address: {
+        street: string;
+        city: string;
+        state: string;
+        zipCode: string;
+    };
+    email: string | null;
+    /** 10 digits, or `null` when not given. */
+    phone: string | null;
+    /** 1. Dollars and cents. */
+    amount: number;
+    /** Form you plan to file. */
+    returnForm: 'form1' | 'form1NRPY';
+}
+export declare function buildMA1ESPayload(data: MA1ESBoundData, values: MA1ESEditableValues): MA1ESSubmitPayload;
+export type { AutoFillJson };
+/**
+ * Maps the backend's canonical auto-fill shape (see `autoFill.ts`) onto MA 1-ES's own values.
+ * `email` has no equivalent in the canonical payer block and stays blank for the filer to enter.
+ */
+export declare function fieldsFromAutoFillJson(autoFill: AutoFillJson): Partial<MA1ESEditableValues>;