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

package/dist/components/tax-forms/states/iowa/IAIA1120ESForm.payload.d.ts

@@ -0,0 +1,38 @@
+import { AutoFillJson } from '../autoFill';
+import { IAIA1120ESBoundData, IAIA1120ESEditableValues } from './IAIA1120ESForm';
+export interface IAIA1120ESSubmitPayload {
+    formCode: 'IA1120ES';
+    state: 'IA';
+    /** 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;
+    /** 1–4. */
+    installment: number;
+    name: string;
+    fein: string;
+    address: {
+        street: string;
+        city: string;
+        state: string;
+        zipCode: string;
+    };
+    /** 10 digits, or `null` when not given. */
+    phone: string | null;
+    /** MM/DD/YYYY — the day the tax year ends. */
+    periodEnding: string;
+    /** Dollars and cents. */
+    amount: number;
+}
+export declare function buildIAIA1120ESPayload(data: IAIA1120ESBoundData, values: IAIA1120ESEditableValues): IAIA1120ESSubmitPayload;
+export type { AutoFillJson };
+/**
+ * Maps the backend's canonical auto-fill shape (see `autoFill.ts`) onto IA 1120ES's own values.
+ * A record from an estimated payment is on a calendar year, so the period ends 12/31.
+ */
+export declare function fieldsFromAutoFillJson(autoFill: AutoFillJson): Partial<IAIA1120ESEditableValues>;

package/dist/components/tax-forms/states/iowa/IAIA1120ESForm.schema.d.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+/** The years a 2026 voucher's period can end in — the prior year through the next. */
+export declare const PERIOD_ENDING_YEARS: number[];
+export declare const iaIA1120ESSchema: z.ZodObject<{
+    payerId: z.ZodNullable<z.ZodNumber>;
+    name: z.ZodString;
+    fein: z.ZodString;
+    address: z.ZodString;
+    city: z.ZodString;
+    state: z.ZodString;
+    zipCode: z.ZodString;
+    phone: z.ZodString;
+    installment: z.ZodString;
+    periodEnding: z.ZodString;
+    amount: z.ZodObject<{
+        dollars: z.ZodString;
+        cents: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;

package/dist/components/tax-forms/states/kansas/KSEstimated.shared.d.ts

@@ -0,0 +1,63 @@
+/**
+ * What Kansas's two estimated-tax vouchers — K-40ES (individuals) and
+ * K-120ES (corporations) — share: the tax year, and the four payments each
+ * voucher set prints with its due date.
+ */
+/** The tax year this edition of the vouchers is filled for. */
+export declare const FORM_TAX_YEAR = 2026;
+/** K-120ES takes whole dollars only (K-40ES prints cents boxes). */
+export declare const AMOUNT_MAX_DIGITS = 10;
+/**
+ * K-40ES — the four calendar-year due dates, one printed on each voucher,
+ * first quarter first (`printed` as the voucher prints it). None falls on a
+ * weekend or legal holiday (the instructions move such a date to the next
+ * regular workday). Fiscal-year filers pay on the 15th day of the 4th, 6th
+ * and 9th months of their fiscal year and the 1st month of the next.
+ */
+export declare const K40ES_QUARTERS: readonly [{
+    readonly value: "1";
+    readonly label: "1st quarter";
+    readonly dueDate: "04/15/2026";
+    readonly printed: "APRIL 15, 2026";
+}, {
+    readonly value: "2";
+    readonly label: "2nd quarter";
+    readonly dueDate: "06/15/2026";
+    readonly printed: "JUNE 15, 2026";
+}, {
+    readonly value: "3";
+    readonly label: "3rd quarter";
+    readonly dueDate: "09/15/2026";
+    readonly printed: "SEPTEMBER 15, 2026";
+}, {
+    readonly value: "4";
+    readonly label: "4th quarter";
+    readonly dueDate: "01/15/2027";
+    readonly printed: "JANUARY 15, 2027";
+}];
+/**
+ * K-120ES — each voucher prints "Voucher is due by the 15th day of the Nth
+ * month of the taxable year". `calendarDueDate` is that day for a 2026
+ * calendar-year corporation; none falls on a weekend or legal holiday.
+ */
+export declare const K120ES_INSTALLMENTS: readonly [{
+    readonly value: "1";
+    readonly label: "Voucher 1";
+    readonly month: "4th";
+    readonly calendarDueDate: "04/15/2026";
+}, {
+    readonly value: "2";
+    readonly label: "Voucher 2";
+    readonly month: "6th";
+    readonly calendarDueDate: "06/15/2026";
+}, {
+    readonly value: "3";
+    readonly label: "Voucher 3";
+    readonly month: "9th";
+    readonly calendarDueDate: "09/15/2026";
+}, {
+    readonly value: "4";
+    readonly label: "Voucher 4";
+    readonly month: "12th";
+    readonly calendarDueDate: "12/15/2026";
+}];

package/dist/components/tax-forms/states/kansas/KSK120ESForm.d.ts

@@ -0,0 +1,49 @@
+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 KSK120ESBoundData {
+    payerDetailId?: number | null;
+    formRecordId?: number | null;
+    statePayrollFormId?: number | null;
+}
+export interface KSK120ESEditableValues {
+    /** The chosen Dashboard business entity. `null` until one is chosen. */
+    payerId: number | null;
+    /** Which voucher, `'1'`–`'4'`; `''` until chosen. */
+    installment: string;
+    /** "For the taxable year beginning … ending …" — MM/DD/YYYY both. */
+    taxYearBeginning: string;
+    taxYearEnding: string;
+    fein: string;
+    name: string;
+    address: string;
+    city: string;
+    state: string;
+    /** `12345` or `12345-6789`. */
+    zipCode: string;
+    /** "Name or Address Change" box. */
+    nameOrAddressChange: boolean;
+    /** Name of contact person — optional, the filer's. */
+    contactName: string;
+    /** Pre-filled from the entity, editable. */
+    phone: string;
+    /** Payment amount — whole dollars, digits only. */
+    amount: string;
+}
+interface KSK120ESFormProps {
+    data: KSK120ESBoundData;
+    /** Starting entries — anything omitted starts blank. */
+    initialValues?: Partial<KSK120ESEditableValues>;
+    /** Fires on every change with the complete set of entries. */
+    onValuesChange?: (values: KSK120ESEditableValues) => 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 KSK120ESForm({ data, initialValues, onValuesChange, onBack, onSubmitted, readOnly }: KSK120ESFormProps): import("react").JSX.Element;
+export {};

package/dist/components/tax-forms/states/kansas/KSK120ESForm.payload.d.ts

@@ -0,0 +1,48 @@
+import { AutoFillJson } from '../autoFill';
+import { KSK120ESBoundData, KSK120ESEditableValues } from './KSK120ESForm';
+export interface KSK120ESSubmitPayload {
+    formCode: 'K120ES';
+    state: 'KS';
+    /** 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;
+    /** Which voucher, 1–4 — due the 15th day of the 4th, 6th, 9th or 12th month of the taxable year. */
+    installment: number;
+    /** `MM/DD/YYYY` both. */
+    taxableYear: {
+        beginning: string;
+        ending: string;
+    };
+    fein: string;
+    corporation: {
+        name: string;
+        address: string;
+        city: string;
+        state: string;
+        zipCode: string;
+    };
+    nameOrAddressChange: boolean;
+    /** `null` when not given. */
+    contactName: string | null;
+    /** 10 digits, or `null` when not given. */
+    phone: string | null;
+    /** Whole dollars. */
+    amount: number;
+}
+export declare function buildKSK120ESPayload(data: KSK120ESBoundData, values: KSK120ESEditableValues): KSK120ESSubmitPayload;
+export type { AutoFillJson };
+/**
+ * Maps the backend's canonical auto-fill shape (see `autoFill.ts`) onto
+ * K-120ES's own values: the corporation (FEIN only for a business, as when
+ * the entity is chosen), the voucher from the tax period (Q1–Q4 → vouchers
+ * 1–4) and the amount rounded to whole dollars, as the voucher takes. The
+ * taxable-year dates keep their calendar-year defaults; the contact name and
+ * the name-or-address-change box aren't on the record.
+ */
+export declare function fieldsFromAutoFillJson(autoFill: AutoFillJson): Partial<KSK120ESEditableValues>;

package/dist/components/tax-forms/states/kansas/KSK120ESForm.schema.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export declare const CONTACT_MAX_LENGTH = 50;
+export declare const ksK120ESSchema: z.ZodObject<{
+    payerId: z.ZodNullable<z.ZodNumber>;
+    installment: z.ZodString;
+    taxYearBeginning: z.ZodString;
+    taxYearEnding: z.ZodString;
+    fein: z.ZodString;
+    name: z.ZodString;
+    address: z.ZodString;
+    city: z.ZodString;
+    state: z.ZodString;
+    zipCode: z.ZodString;
+    nameOrAddressChange: z.ZodBoolean;
+    contactName: z.ZodString;
+    phone: z.ZodString;
+    amount: z.ZodString;
+}, z.core.$strip>;

package/dist/components/tax-forms/states/kansas/KSK40ESForm.d.ts

@@ -0,0 +1,51 @@
+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 KSK40ESBoundData {
+    payerDetailId?: number | null;
+    formRecordId?: number | null;
+    statePayrollFormId?: number | null;
+}
+export interface KSK40ESEditableValues {
+    /** The chosen Dashboard individual entity. `null` until one is chosen. */
+    payerId: number | null;
+    /** Which quarterly voucher, `'1'`–`'4'`; `''` until chosen. */
+    quarter: string;
+    firstName: string;
+    middleInitial: string;
+    lastName: string;
+    ssn: string;
+    address: string;
+    city: string;
+    state: string;
+    /** `12345` or `12345-6789`. */
+    zipCode: string;
+    spouseFirstName: string;
+    spouseMiddleInitial: string;
+    spouseLastName: string;
+    spouseSsn: string;
+    /** "Name or Address Change" box. */
+    nameOrAddressChange: boolean;
+    /** Pre-filled from the entity, editable. */
+    phone: string;
+    /** Payment amount — dollars and cents. */
+    amount: AmountParts;
+}
+interface KSK40ESFormProps {
+    data: KSK40ESBoundData;
+    /** Starting entries — anything omitted starts blank. */
+    initialValues?: Partial<KSK40ESEditableValues>;
+    /** Fires on every change with the complete set of entries. */
+    onValuesChange?: (values: KSK40ESEditableValues) => 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 KSK40ESForm({ data, initialValues, onValuesChange, onBack, onSubmitted, readOnly }: KSK40ESFormProps): import("react").JSX.Element;
+export {};

package/dist/components/tax-forms/states/kansas/KSK40ESForm.payload.d.ts

@@ -0,0 +1,56 @@
+import { AutoFillJson } from '../autoFill';
+import { KSK40ESBoundData, KSK40ESEditableValues } from './KSK40ESForm';
+export interface KSK40ESSubmitPayload {
+    formCode: 'K40ES';
+    state: 'KS';
+    /** 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 quarterly voucher, 1–4. */
+    quarter: number;
+    /** `MM/DD/YYYY`. */
+    dueDate: string;
+    /** `nameControl` — the first four letters of the last name, upper case, as the voucher asks. */
+    taxpayer: {
+        ssn: string;
+        firstName: string;
+        middleInitial: string | null;
+        lastName: string;
+        nameControl: string;
+    };
+    /** `null` unless it's a joint return. */
+    spouse: {
+        ssn: string;
+        firstName: string;
+        middleInitial: string | null;
+        lastName: string;
+        nameControl: string;
+    } | null;
+    address: {
+        street: string;
+        city: string;
+        state: string;
+        zipCode: string;
+    };
+    nameOrAddressChange: boolean;
+    /** 10 digits, or `null` when not given. */
+    phone: string | null;
+    /** Dollars and cents. */
+    amount: number;
+}
+export declare function buildKSK40ESPayload(data: KSK40ESBoundData, values: KSK40ESEditableValues): KSK40ESSubmitPayload;
+export type { AutoFillJson };
+/**
+ * Maps the backend's canonical auto-fill shape (see `autoFill.ts`) onto
+ * K-40ES's own values: the taxpayer (SSN only for an individual, as when the
+ * entity is chosen), the spouse when the record has one, the quarterly
+ * voucher from the tax period and the amount in dollars and cents. The
+ * initials and the name-or-address-change box aren't on the record.
+ */
+export declare function fieldsFromAutoFillJson(autoFill: AutoFillJson): Partial<KSK40ESEditableValues>;

package/dist/components/tax-forms/states/kansas/KSK40ESForm.schema.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+export declare const NAME_MAX_LENGTH = 50;
+/** "Please use UPPER CASE letters to print the first four letters of" the last name. */
+export declare const nameControlOf: (lastName: string) => string;
+export declare const ksK40ESSchema: z.ZodObject<{
+    payerId: z.ZodNullable<z.ZodNumber>;
+    quarter: z.ZodString;
+    firstName: z.ZodString;
+    middleInitial: z.ZodString;
+    lastName: z.ZodString;
+    spouseFirstName: z.ZodString;
+    spouseMiddleInitial: z.ZodString;
+    spouseLastName: z.ZodString;
+    ssn: z.ZodString;
+    spouseSsn: z.ZodString;
+    address: z.ZodString;
+    city: z.ZodString;
+    state: z.ZodString;
+    zipCode: z.ZodString;
+    nameOrAddressChange: z.ZodBoolean;
+    phone: z.ZodString;
+    amount: z.ZodObject<{
+        dollars: z.ZodString;
+        cents: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;

package/dist/components/tax-forms/states/kentucky/KY720ESForm.d.ts

@@ -0,0 +1,52 @@
+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 KY720ESBoundData {
+    payerDetailId?: number | null;
+    formRecordId?: number | null;
+    statePayrollFormId?: number | null;
+}
+export interface KY720ESEditableValues {
+    /** The record's Dashboard business entity. */
+    payerId: number | null;
+    /** Which of the three installments, `'1'`–`'3'` — from the record. */
+    installment: string;
+    /** KY Corporation/LLET Account No — 9 digits. */
+    accountNumber: string;
+    /** Taxable Year Ending, `MMYY`. */
+    taxableYearEnding: string;
+    entityName: string;
+    fein: string;
+    address: string;
+    city: string;
+    state: string;
+    /** `12345` or `12345-6789`. */
+    zipCode: string;
+    /** Pre-filled from the entity, editable. */
+    telephone: string;
+    /** "Print or Type Name of Responsible Party". */
+    responsibleParty: string;
+    /** One of `FORM_TYPES`, `''` until chosen. */
+    formType: string;
+    corporationIncomeTax: AmountParts;
+    llet: AmountParts;
+    total: AmountParts;
+}
+interface KY720ESFormProps {
+    data: KY720ESBoundData;
+    /** Starting entries — anything omitted starts blank. */
+    initialValues?: Partial<KY720ESEditableValues>;
+    /** Fires on every change with the complete set of entries. */
+    onValuesChange?: (values: KY720ESEditableValues) => 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 KY720ESForm({ data, initialValues, onValuesChange, onBack, onSubmitted, readOnly }: KY720ESFormProps): import("react").JSX.Element;
+export {};

package/dist/components/tax-forms/states/kentucky/KY720ESForm.payload.d.ts

@@ -0,0 +1,49 @@
+import { AutoFillJson } from '../autoFill';
+import { KY720ESBoundData, KY720ESEditableValues } from './KY720ESForm';
+import { KY720ESFormType } from './KY720ESForm.schema';
+export interface KY720ESSubmitPayload {
+    formCode: '720ES';
+    state: 'KY';
+    /** The record's 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;
+    /** Which of the three installments, 1–3. */
+    installment: number;
+    /** The installment's due date, `MM/DD/YYYY`. */
+    dueDate: string;
+    /** 9 digits. */
+    accountNumber: string;
+    /** `MMYY`. */
+    taxableYearEnding: string;
+    entity: {
+        name: string;
+        address: string;
+        city: string;
+        state: string;
+        zipCode: string;
+    };
+    /** 9 digits, no dash. */
+    fein: string;
+    /** 10 digits, or `null` when not given. */
+    telephone: string | null;
+    responsibleParty: string;
+    formType: KY720ESFormType;
+    /** Dollars and cents, as typed on the voucher. */
+    corporationIncomeTax: number;
+    limitedLiabilityEntityTax: number;
+    total: number;
+}
+export declare function buildKY720ESPayload(data: KY720ESBoundData, values: KY720ESEditableValues): KY720ESSubmitPayload;
+export type { AutoFillJson };
+/**
+ * Maps the backend's canonical auto-fill shape (see `autoFill.ts`) onto KY 720-ES's values. The
+ * record's quarter maps to the installment due in it (Q2/Q3/Q4; Q1 has none); a record is on a
+ * calendar year. The amount is the voucher's Total — its income tax / LLET split is the filer's.
+ */
+export declare function fieldsFromAutoFillJson(autoFill: AutoFillJson): Partial<KY720ESEditableValues>;

package/dist/components/tax-forms/states/kentucky/KY720ESForm.schema.d.ts

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+/** The tax year this edition of the voucher (2026, 41A720ES0003) is filled for. */
+export declare const FORM_TAX_YEAR = 2026;
+export declare const ACCOUNT_NUMBER_LENGTH = 9;
+export declare const NAME_MAX_LENGTH = 50;
+/** A calendar-year filer's "Taxable Year Ending (MMYY)". */
+export declare const CALENDAR_YEAR_ENDING: string;
+/** The two-digit years a taxable year beginning in 2026 can end in. */
+export declare const YEAR_ENDING_YEARS: string[];
+/**
+ * The three installments (instructions, "Payment Dates for Calendar Year
+ * Filers"): 50% June 15, 25% September 15, 25% December 15 — the 2026 dates
+ * (none falls on a weekend). The voucher prints no number or date.
+ * `taxPeriod` is the record quarter each installment is bound from — the
+ * quarter its due date falls in.
+ */
+export declare const INSTALLMENTS: readonly [{
+    readonly value: "1";
+    readonly taxPeriod: "Q2";
+    readonly dueDate: "06/15/2026";
+}, {
+    readonly value: "2";
+    readonly taxPeriod: "Q3";
+    readonly dueDate: "09/15/2026";
+}, {
+    readonly value: "3";
+    readonly taxPeriod: "Q4";
+    readonly dueDate: "12/15/2026";
+}];
+/** "Form Type", as printed. */
+export declare const FORM_TYPES: readonly [{
+    readonly value: "720";
+    readonly label: "720";
+}, {
+    readonly value: "725";
+    readonly label: "725";
+}, {
+    readonly value: "720U";
+    readonly label: "720U";
+}, {
+    readonly value: "PTE-S Corporation";
+    readonly label: "PTE – S Corporation";
+}, {
+    readonly value: "PTE-General Partnership";
+    readonly label: "PTE – General Partnership";
+}, {
+    readonly value: "PTE-Partnership";
+    readonly label: "PTE – Partnership";
+}];
+export type KY720ESFormType = (typeof FORM_TYPES)[number]['value'];
+export declare const ky720ESSchema: z.ZodObject<{
+    payerId: z.ZodNullable<z.ZodNumber>;
+    installment: z.ZodString;
+    accountNumber: z.ZodString;
+    taxableYearEnding: z.ZodString;
+    entityName: z.ZodString;
+    fein: z.ZodString;
+    address: z.ZodString;
+    city: z.ZodString;
+    state: z.ZodString;
+    zipCode: z.ZodString;
+    telephone: z.ZodString;
+    responsibleParty: z.ZodString;
+    formType: z.ZodString;
+    corporationIncomeTax: z.ZodObject<{
+        dollars: z.ZodString;
+        cents: z.ZodString;
+    }, z.core.$strip>;
+    llet: z.ZodObject<{
+        dollars: z.ZodString;
+        cents: z.ZodString;
+    }, z.core.$strip>;
+    total: z.ZodObject<{
+        dollars: z.ZodString;
+        cents: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;

package/dist/components/tax-forms/states/kentucky/KY740ESForm.d.ts

@@ -0,0 +1,45 @@
+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 KY740ESBoundData {
+    payerDetailId?: number | null;
+    formRecordId?: number | null;
+    statePayrollFormId?: number | null;
+}
+export interface KY740ESEditableValues {
+    /** The chosen Dashboard individual entity. `null` until one is chosen. */
+    payerId: number | null;
+    /** Which of the four installment vouchers, `'1'`–`'4'`; `''` until chosen. */
+    installment: string;
+    ssn: string;
+    lastName: string;
+    firstName: string;
+    address: string;
+    city: string;
+    state: string;
+    /** `12345` or `12345-6789`. */
+    zipCode: string;
+    /** "Check if Estate or Trust — Fiduciary Tax" — the filer's. */
+    isFiduciary: boolean;
+    spouseSsn: string;
+    spouseName: string;
+    /** Amount paid — whole dollars, digits only. */
+    amount: string;
+}
+interface KY740ESFormProps {
+    data: KY740ESBoundData;
+    /** Starting entries — anything omitted starts blank. */
+    initialValues?: Partial<KY740ESEditableValues>;
+    /** Fires on every change with the complete set of entries. */
+    onValuesChange?: (values: KY740ESEditableValues) => 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 KY740ESForm({ data, initialValues, onValuesChange, onBack, onSubmitted, readOnly }: KY740ESFormProps): import("react").JSX.Element;
+export {};

package/dist/components/tax-forms/states/kentucky/KY740ESForm.payload.d.ts

@@ -0,0 +1,50 @@
+import { AutoFillJson } from '../autoFill';
+import { KY740ESBoundData, KY740ESEditableValues } from './KY740ESForm';
+export interface KY740ESSubmitPayload {
+    formCode: '740ES';
+    state: 'KY';
+    /** 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;
+    /** `MM/DD/YYYY` — the "Year Ending" the voucher prints. */
+    yearEnding: string;
+    /** Which of the four installment vouchers, 1–4. */
+    installment: number;
+    /** `MM/DD/YYYY`. */
+    dueDate: string;
+    /** "Check if Estate or Trust — Fiduciary Tax". */
+    isFiduciary: boolean;
+    taxpayer: {
+        ssn: string;
+        firstName: string;
+        lastName: string;
+    };
+    /** `null` unless a spouse is given. */
+    spouse: {
+        ssn: string;
+        name: string;
+    } | null;
+    address: {
+        street: string;
+        city: string;
+        state: string;
+        zipCode: string;
+    };
+    /** Whole dollars. */
+    amount: number;
+}
+export declare function buildKY740ESPayload(data: KY740ESBoundData, values: KY740ESEditableValues): KY740ESSubmitPayload;
+export type { AutoFillJson };
+/**
+ * Maps the backend's canonical auto-fill shape (see `autoFill.ts`) onto
+ * 740-ES's values: the record's quarter is the installment voucher (Q1 -> 1 …
+ * Q4 -> 4) and its amount, in whole dollars, the amount paid. The spouse's
+ * name is first + last, as from the entity; the fiduciary box stays unchecked.
+ */
+export declare function fieldsFromAutoFillJson(autoFill: AutoFillJson): Partial<KY740ESEditableValues>;

package/dist/components/tax-forms/states/kentucky/KY740ESForm.schema.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export declare const NAME_MAX_LENGTH = 50;
+export declare const ky740ESSchema: z.ZodObject<{
+    payerId: z.ZodNullable<z.ZodNumber>;
+    installment: z.ZodString;
+    ssn: z.ZodString;
+    isFiduciary: z.ZodBoolean;
+    lastName: z.ZodString;
+    firstName: z.ZodString;
+    spouseSsn: z.ZodString;
+    spouseName: z.ZodString;
+    address: z.ZodString;
+    city: z.ZodString;
+    state: z.ZodString;
+    zipCode: z.ZodString;
+    amount: z.ZodString;
+}, z.core.$strip>;