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

package/dist/api/stateForms.d.ts

@@ -0,0 +1,20 @@
+/**
+ * No `confirmationId` here — submitting only means the filer sent it to us, not that it's been
+ * filed with the state. The real confirmation id is recorded later by an admin, once actually
+ * filed (see the Tax Forms architecture plan's Status lifecycle).
+ */
+export interface StateFormSubmitResponse {
+    submittedAt: string;
+}
+/** Every form's payload carries `state`/`formCode` (see `AL40ESForm.payload.ts`); this is what makes one shared route work. */
+interface TaxFormPayload {
+    formCode: string;
+    state: string;
+}
+/**
+ * `AL` + `40ES` -> `al-40es`. Kept as one function so every form's route
+ * name is derived the same way — a form never invents its own spelling.
+ */
+export declare function taxFormRouteName(payload: TaxFormPayload): string;
+export declare function submitTaxForm<TPayload extends TaxFormPayload>(payload: TPayload): Promise<StateFormSubmitResponse>;
+export {};

package/dist/api/taxForms.d.ts

@@ -0,0 +1,46 @@
+import { PagedResult } from '../types/pagination';
+export interface StatePayrollFormSummary {
+    statePayrollFormId: number;
+    entityId: number;
+    state: string;
+    reason: string;
+    formCode: string;
+    status: string;
+    /**
+     * The underlying state payment's status (Draft/Scheduled/Processing/Accepted/Rejected) —
+     * Estimated/Income Tax forms are never submitted through this platform, so the UI shows this
+     * instead of `status` until an admin has recorded a real filing outcome.
+     */
+    paymentStatus: string;
+    /** 9-digit reference the filer can quote for this form — stable for its lifetime. */
+    referenceNumber: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface StatePayrollFormIds {
+    payerDetailId: number | null;
+    formRecordId: number | null;
+    statePayrollFormId: number | null;
+}
+export interface StatePayrollFormDetail {
+    ids: StatePayrollFormIds;
+    entityId: number;
+    state: string;
+    reason: string;
+    formCode: string;
+    status: string;
+    paymentStatus: string;
+    referenceNumber: string;
+    formDataRawJson: string;
+}
+export interface GetTaxFormsQuery {
+    entityId: number;
+    state?: string;
+    reason?: string;
+    pageNumber?: number;
+    pageSize?: number;
+}
+export declare function getTaxForms({ entityId, state, reason, pageNumber, pageSize, }: GetTaxFormsQuery): Promise<PagedResult<StatePayrollFormSummary>>;
+export declare function getTaxFormById(statePayrollFormId: number): Promise<StatePayrollFormDetail>;
+/** Persists in-progress edits — `formData` is whatever shape the open form's own schema uses. */
+export declare function updateTaxFormData(statePayrollFormId: number, formData: unknown): Promise<StatePayrollFormDetail>;

package/dist/components/tax-forms/TaxFormDetailPanel.d.ts

@@ -0,0 +1,6 @@
+interface TaxFormDetailPanelProps {
+    statePayrollFormId: number;
+    onBack: () => void;
+}
+export declare function TaxFormDetailPanel({ statePayrollFormId, onBack }: TaxFormDetailPanelProps): import("react").JSX.Element;
+export {};

package/dist/components/tax-forms/TaxFormRecordView.d.ts

@@ -0,0 +1,4 @@
+export declare function TaxFormRecordView({ statePayrollFormId, onBack, }: {
+    statePayrollFormId: number;
+    onBack: () => void;
+}): import("react").JSX.Element;

package/dist/components/tax-forms/TaxFormStatusBadge.d.ts

@@ -0,0 +1,8 @@
+interface TaxFormStatusBadgeProps {
+    status: string;
+    /** When given along with `paymentStatus`, a non-Withholding, not-yet-Accepted/Rejected form shows payment status instead. */
+    reason?: string;
+    paymentStatus?: string;
+}
+export declare function TaxFormStatusBadge({ status, reason, paymentStatus }: TaxFormStatusBadgeProps): import("react").JSX.Element;
+export {};

package/dist/components/tax-forms/TaxFormsWorklist.d.ts

@@ -0,0 +1,8 @@
+import { StatePayrollFormSummary } from '../../api/taxForms';
+interface TaxFormsWorklistProps {
+    entityId: number | null;
+    onCreate: () => void;
+    onOpen: (form: StatePayrollFormSummary) => void;
+}
+export declare function TaxFormsWorklist({ entityId, onCreate, onOpen }: TaxFormsWorklistProps): import("react").JSX.Element;
+export {};

package/dist/components/tax-forms/states/TaxFormEntitySelect.d.ts

@@ -0,0 +1,13 @@
+import { EntityDetailsResponse } from '../../../types/entity';
+export declare function TaxFormEntitySelect({ entityId, onChange, hint, bare, error, accountType, }: {
+    entityId: number | null;
+    /** Omit for preview — the chosen entity shows as text. */
+    onChange?: (entity: EntityDetailsResponse) => void;
+    hint?: string;
+    /** Drop the card chrome when it sits inside a form's own block. */
+    bare?: boolean;
+    /** Shown under the select, and turns it red — e.g. no entity chosen when one is required. */
+    error?: string;
+    /** Only list entities of this type — e.g. `'Business'` for a corporate return. Omit to list all. */
+    accountType?: 'Business' | 'Individual';
+}): import("react").JSX.Element;

package/dist/components/tax-forms/states/alabama/AL40ESForm.autofill.d.ts

@@ -0,0 +1,26 @@
+import { AL40ESEditableValues } from './AL40ESForm';
+interface AutoFillPayer {
+    firstName?: string;
+    lastName?: string;
+    ssn?: string;
+    address1?: string;
+    address2?: string | null;
+    city?: string;
+    state?: string;
+    zipCode?: string;
+    phone?: string;
+    spouseFirstName?: string | null;
+    spouseSsn?: string | null;
+}
+interface AutoFillPayment {
+    taxPeriod?: string | null;
+    amount?: number;
+}
+export interface AutoFillJson {
+    /** Added by `TaxFormRecordView` from the response's top-level `entityId` — not part of the backend's own JSON blob. */
+    entityId?: number;
+    payer?: AutoFillPayer;
+    payment?: AutoFillPayment;
+}
+export declare function fieldsFromAutoFillJson(autoFill: AutoFillJson): Partial<AL40ESEditableValues>;
+export {};

package/dist/components/tax-forms/states/alabama/AL40ESForm.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 AL40ESBoundData {
+    payerDetailId?: number | null;
+    formRecordId?: number | null;
+    statePayrollFormId?: number | null;
+}
+export interface AL40ESEditableValues {
+    /** The chosen Dashboard individual entity. `null` until one is chosen. */
+    payerId: number | null;
+    /** Which of the four vouchers, `'1'`–`'4'`; `''` until chosen. */
+    voucher: string;
+    primaryFirstName: string;
+    lastName: string;
+    mailingAddress: string;
+    city: string;
+    state: string;
+    /** `12345` or `12345-6789`. */
+    zipCode: string;
+    primarySsn: string;
+    spouseFirstName: string;
+    spouseSsn: string;
+    daytimePhone: string;
+    isFiscalYear: boolean;
+    /** MM/DD/YYYY — only for a fiscal year. */
+    fiscalYearBeginning: string;
+    /** MM/DD/YYYY — only for a fiscal year. */
+    fiscalYearEnding: string;
+    /** Amount paid with voucher — dollars and cents. */
+    amount: AmountParts;
+}
+interface AL40ESFormProps {
+    data: AL40ESBoundData;
+    /** Starting entries — anything omitted starts blank. */
+    initialValues?: Partial<AL40ESEditableValues>;
+    /** Fires on every change with the complete set of entries. */
+    onValuesChange?: (values: AL40ESEditableValues) => 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 AL40ESForm({ data, initialValues, onValuesChange, onBack, onSubmitted, readOnly }: AL40ESFormProps): import("react").JSX.Element;
+export {};

package/dist/components/tax-forms/states/alabama/AL40ESForm.payload.d.ts

@@ -0,0 +1,44 @@
+import { AL40ESBoundData, AL40ESEditableValues } from './AL40ESForm';
+export interface AL40ESSubmitPayload {
+    formCode: '40ES';
+    state: 'AL';
+    /** 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 voucher's due date, `MM/DD/YYYY`. */
+    dueDate: string;
+    primary: {
+        firstName: string;
+        lastName: string;
+        ssn: string;
+    };
+    /** `null` without a spouse. */
+    spouse: {
+        firstName: string;
+        ssn: string;
+    } | null;
+    address: {
+        street: string;
+        city: string;
+        state: string;
+        zipCode: string;
+    };
+    /** 10 digits, or `null` when not given. */
+    daytimePhone: string | null;
+    /** `null` for a calendar year. `MM/DD/YYYY`. */
+    fiscalYear: {
+        beginning: string;
+        ending: string;
+    } | null;
+    /** Dollars and cents. */
+    amount: number;
+}
+export declare function buildAL40ESPayload(data: AL40ESBoundData, values: AL40ESEditableValues): AL40ESSubmitPayload;

package/dist/components/tax-forms/states/alabama/AL40ESForm.preview.d.ts

@@ -0,0 +1,2 @@
+import { AL40ESBoundData } from './AL40ESForm';
+export declare const AL40ES_TEMPORARY_BOUND_DATA: AL40ESBoundData;

package/dist/components/tax-forms/states/alabama/AL40ESForm.schema.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+/** The tax year this edition of the voucher is filled for. */
+export declare const FORM_TAX_YEAR = 2026;
+export declare const NAME_MAX_LENGTH = 50;
+/**
+ * The four vouchers in the 2026 40ES package. They print alike — no number
+ * or date on the voucher — so these come from the instructions' schedule
+ * ("Required Filing Date"). None falls on a weekend.
+ */
+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";
+}];
+export declare const al40esSchema: z.ZodObject<{
+    payerId: z.ZodNullable<z.ZodNumber>;
+    voucher: z.ZodString;
+    primaryFirstName: z.ZodString;
+    spouseFirstName: z.ZodString;
+    lastName: z.ZodString;
+    mailingAddress: z.ZodString;
+    city: z.ZodString;
+    state: z.ZodString;
+    zipCode: z.ZodString;
+    daytimePhone: z.ZodString;
+    primarySsn: z.ZodString;
+    spouseSsn: z.ZodString;
+    isFiscalYear: z.ZodBoolean;
+    fiscalYearBeginning: z.ZodString;
+    fiscalYearEnding: z.ZodString;
+    amount: z.ZodObject<{
+        dollars: z.ZodString;
+        cents: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;

package/dist/components/tax-forms/states/alabama/ALA3Form.autofill.d.ts

@@ -0,0 +1,14 @@
+import { ALA3BoundData, ALA3EditableValues } from './ALA3Form';
+import { ALWithholdingAutoFillJson } from './ALWithholding.shared';
+export interface AutoFillJson extends ALWithholdingAutoFillJson {
+    payment?: ALWithholdingAutoFillJson['payment'] & {
+        taxYear?: string;
+        amount?: number;
+    };
+}
+export declare function boundDataFromAutoFillJson(autoFill: AutoFillJson, ids: {
+    payerDetailId: number | null;
+    formRecordId: number | null;
+    statePayrollFormId: number | null;
+}): ALA3BoundData;
+export declare function fieldsFromAutoFillJson(autoFill: AutoFillJson): Partial<ALA3EditableValues>;

package/dist/components/tax-forms/states/alabama/ALA3Form.calc.d.ts

@@ -0,0 +1,25 @@
+import { ALA3EditableValues } from './ALA3Form';
+/** The twelve printed rows; the quarter-closing months carry their quarter. */
+export declare const A3_MONTHS: {
+    name: string;
+    quarter?: number;
+}[];
+/** `"March (1st QTR)"`, as the table prints it. */
+export declare function monthLabel(index: number): string;
+/** Below this, an overpayment can only be credited, not refunded. */
+export declare const A3_MIN_REFUND_CENTS = 10000;
+/** A-3 is due January 31 of the following year. */
+export declare function dueDate(taxYear: string): Date;
+export interface ALA3Totals {
+    /** Column 1, summed — shown under the table, not a numbered line. */
+    totalWithheldCents: number;
+    /** Line 1 — column 2, summed. */
+    totalRemittedCents: number;
+    /** Line 2. */
+    w2WithheldCents: number;
+    /** Line 3. */
+    additionalDueCents: number;
+    /** Line 4. */
+    overpaymentCents: number;
+}
+export declare function computeALA3Totals(values: Pick<ALA3EditableValues, 'withheld' | 'remitted' | 'w2Withheld'>): ALA3Totals;

package/dist/components/tax-forms/states/alabama/ALA3Form.d.ts

@@ -0,0 +1,39 @@
+import { StateFormSubmitResponse } from '../../../../api/stateForms';
+import { AmountParts } from '../stateFormKit';
+import { ALEmployerValues } from './ALWithholding.shared';
+/** Filled in from the state payment — displayed, never edited here. */
+export interface ALA3BoundData {
+    taxYear: string;
+    /** The remittance enclosed with the return — line 3 must equal it. `0.00` when nothing more is owed. */
+    paymentAmount: AmountParts;
+    /** Ids the backend issues once a return exists, sent back on submit so it updates that record. Absent (`null`) for a new return. Never shown. */
+    payerDetailId?: number | null;
+    formRecordId?: number | null;
+    statePayrollFormId?: number | null;
+}
+export type ALA3OverpaymentChoice = '' | 'refund' | 'credit';
+export interface ALA3EditableValues extends ALEmployerValues {
+    /** Number of employee wage statements / information returns transmitted. */
+    statementsCount: string;
+    /** Column 1, January first — twelve entries. */
+    withheld: AmountParts[];
+    /** Column 2, January first — twelve entries. */
+    remitted: AmountParts[];
+    /** Line 2 — total withheld as shown on the W-2s / 1099s. */
+    w2Withheld: AmountParts;
+    /** What to do with a line 4 overpayment. */
+    overpaymentChoice: ALA3OverpaymentChoice;
+}
+interface ALA3FormProps {
+    data: ALA3BoundData;
+    /** Starting entries — anything omitted starts blank. */
+    initialValues?: Partial<ALA3EditableValues>;
+    /** Fires on every change with the complete set of entries. */
+    onValuesChange?: (values: ALA3EditableValues) => 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;
+}
+export declare function ALA3Form({ data, initialValues, onValuesChange, onBack, onSubmitted }: ALA3FormProps): import("react").JSX.Element;
+export {};

package/dist/components/tax-forms/states/alabama/ALA3Form.payload.d.ts

@@ -0,0 +1,32 @@
+import { ALA3BoundData, ALA3EditableValues } from './ALA3Form';
+import { buildALEmployerPayload } from './ALWithholding.shared';
+export interface ALA3SubmitPayload extends ReturnType<typeof buildALEmployerPayload> {
+    formCode: 'A3';
+    state: 'AL';
+    /** 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: string;
+    /** `MM/DD/YYYY` — January 31 of the following year. */
+    dueDate: string;
+    /** Number of W-2 / 1099 statements transmitted with the return. */
+    statementsCount: number;
+    /** Twelve rows, January first. */
+    months: {
+        month: number;
+        taxWithheld: number;
+        taxRemitted: number;
+    }[];
+    lines: {
+        totalRemitted: number;
+        w2Withheld: number;
+        additionalDue: number;
+        overpayment: number;
+    };
+    /** Only when line 4 has an overpayment. */
+    overpaymentDisposition: 'refund' | 'credit' | null;
+}
+export declare function buildALA3Payload(data: ALA3BoundData, values: ALA3EditableValues): ALA3SubmitPayload;

package/dist/components/tax-forms/states/alabama/ALA3Form.preview.d.ts

@@ -0,0 +1,2 @@
+import { ALA3BoundData } from './ALA3Form';
+export declare const ALA3_TEMPORARY_BOUND_DATA: ALA3BoundData;

package/dist/components/tax-forms/states/alabama/ALA3Form.schema.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import { AmountParts } from '../../../../lib/fieldRules';
+export declare function createALA3Schema(paymentAmount: AmountParts): z.ZodObject<{
+    statementsCount: z.ZodString;
+    withheld: z.ZodArray<z.ZodObject<{
+        dollars: z.ZodString;
+        cents: z.ZodString;
+    }, z.core.$strip>>;
+    remitted: z.ZodArray<z.ZodObject<{
+        dollars: z.ZodString;
+        cents: z.ZodString;
+    }, z.core.$strip>>;
+    w2Withheld: z.ZodObject<{
+        dollars: z.ZodString;
+        cents: z.ZodString;
+    }, z.core.$strip>;
+    overpaymentChoice: z.ZodEnum<{
+        "": "";
+        credit: "credit";
+        refund: "refund";
+    }>;
+    accountNumber: z.ZodString;
+    name: z.ZodString;
+    address: z.ZodString;
+    city: z.ZodString;
+    state: z.ZodString;
+    zipCode: z.ZodString;
+    isAddressChange: z.ZodBoolean;
+    signature: z.ZodString;
+    title: z.ZodString;
+    signatureDate: z.ZodString;
+}, z.core.$strip>;

package/dist/components/tax-forms/states/alabama/ALEmployerReturnForm.autofill.d.ts

@@ -0,0 +1,8 @@
+import { ALEmployerReturnEditableValues } from './ALEmployerReturnForm';
+import { ALWithholdingAutoFillJson } from './ALWithholding.shared';
+export interface AutoFillJson extends ALWithholdingAutoFillJson {
+    payment?: ALWithholdingAutoFillJson['payment'] & {
+        amount?: number;
+    };
+}
+export declare function fieldsFromAutoFillJson(autoFill: AutoFillJson): Partial<ALEmployerReturnEditableValues>;

package/dist/components/tax-forms/states/alabama/ALEmployerReturnForm.calc.d.ts

@@ -0,0 +1,33 @@
+import { ALEmployerReturnEditableValues } from './ALEmployerReturnForm';
+export type ALEmployerReturnVariant = 'A-1' | 'A-6';
+export interface ALEmployerReturnPeriod {
+    taxYear: string;
+    /** A-1: the quarter, `'1'`–`'4'`. A-6: the month, `'1'`–`'12'`. */
+    period: string;
+}
+/** Last day of the month / quarter reported — what Period Covered prints. */
+export declare function periodEnd(variant: ALEmployerReturnVariant, period: ALEmployerReturnPeriod): Date;
+/**
+ * A-6 is due the 15th of the following month; A-1 the last day of the month
+ * following the quarter.
+ */
+export declare function dueDate(variant: ALEmployerReturnVariant, period: ALEmployerReturnPeriod): Date;
+/**
+ * The period a typed Period Covered date closes — `null` unless it's a real
+ * date that ends one: the last day of a calendar quarter for A-1 (03/31,
+ * 06/30, 09/30, 12/31), the last day of a month for A-6.
+ */
+export declare function periodFromPeriodCovered(variant: ALEmployerReturnVariant, value: string): ALEmployerReturnPeriod | null;
+/** `"Q3 2026"` / `"August 2026"`. */
+export declare function periodLabel(variant: ALEmployerReturnVariant, period: ALEmployerReturnPeriod): string;
+export interface ALEmployerReturnTotals {
+    taxWithheldCents: number;
+    /** Always 0 on A-6. */
+    priorRemittedCents: number;
+    creditCents: number;
+    penaltyCents: number;
+    interestCents: number;
+    /** Line 8. */
+    totalDueCents: number;
+}
+export declare function computeALEmployerReturnTotals(variant: ALEmployerReturnVariant, values: Pick<ALEmployerReturnEditableValues, 'taxWithheld' | 'priorRemitted' | 'credit' | 'penalty' | 'interest'>): ALEmployerReturnTotals;

package/dist/components/tax-forms/states/alabama/ALEmployerReturnForm.d.ts

@@ -0,0 +1,47 @@
+import { StateFormSubmitResponse } from '../../../../api/stateForms';
+import { AmountParts } from '../stateFormKit';
+import { ALEmployerValues } from './ALWithholding.shared';
+/**
+ * Ids the backend issues once a return exists, sent back on submit so it
+ * updates that record. Absent (`null`) for a new return. Never shown.
+ */
+export interface ALEmployerReturnBoundData {
+    payerDetailId?: number | null;
+    formRecordId?: number | null;
+    statePayrollFormId?: number | null;
+}
+export interface ALEmployerReturnEditableValues extends ALEmployerValues {
+    /** The chosen Dashboard entity — the payer. `null` until one is chosen. */
+    payerId: number | null;
+    /** MM/DD/YYYY — the last day of the quarter (A-1) or month (A-6) the return covers. */
+    periodCovered: string;
+    /** Line 1 — no longer withholding, cancel the account. */
+    isCancellingAccount: boolean;
+    /** Line 2 — digits only. */
+    employeeCount: string;
+    /** Line 3. */
+    taxWithheld: AmountParts;
+    /** Line 4 — A-1 only. */
+    priorRemitted: AmountParts;
+    /** Line 5. */
+    credit: AmountParts;
+    /** Line 6. */
+    penalty: AmountParts;
+    /** Line 7. */
+    interest: AmountParts;
+    /** Line 9. */
+    amountRemitted: AmountParts;
+}
+export interface ALEmployerReturnFormProps {
+    data: ALEmployerReturnBoundData;
+    /** Starting entries — anything omitted starts blank. */
+    initialValues?: Partial<ALEmployerReturnEditableValues>;
+    /** Fires on every change with the complete set of entries. */
+    onValuesChange?: (values: ALEmployerReturnEditableValues) => 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;
+}
+export declare function ALA1Form(props: ALEmployerReturnFormProps): import("react").JSX.Element;
+export declare function ALA6Form(props: ALEmployerReturnFormProps): import("react").JSX.Element;

package/dist/components/tax-forms/states/alabama/ALEmployerReturnForm.payload.d.ts

@@ -0,0 +1,37 @@
+import { ALEmployerReturnBoundData, ALEmployerReturnEditableValues } from './ALEmployerReturnForm';
+import { ALEmployerReturnVariant } from './ALEmployerReturnForm.calc';
+import { buildALEmployerPayload } from './ALWithholding.shared';
+export interface ALEmployerReturnSubmitPayload extends ReturnType<typeof buildALEmployerPayload> {
+    formCode: 'A1' | 'A6';
+    state: 'AL';
+    /** The chosen Dashboard entity — the payer. */
+    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: string;
+    /** A-1: the quarter (1–4). A-6: the month (1–12). */
+    period: number;
+    /** `MMDDYYYY` — last day of the period, as the form prints it. */
+    periodCovered: string;
+    /** `MM/DD/YYYY`. */
+    dueDate: string;
+    /** Line 1. */
+    isCancellingAccount: boolean;
+    /** Line 2 — `null` when the account is being cancelled. */
+    employeeCount: number | null;
+    lines: {
+        taxWithheld: number;
+        /** A-1 only; `null` on A-6, where the line doesn't apply. */
+        priorRemitted: number | null;
+        credit: number;
+        penalty: number;
+        interest: number;
+        totalDue: number;
+        amountRemitted: number;
+    };
+}
+export declare function buildALEmployerReturnPayload(variant: ALEmployerReturnVariant, data: ALEmployerReturnBoundData, values: ALEmployerReturnEditableValues): ALEmployerReturnSubmitPayload;

package/dist/components/tax-forms/states/alabama/ALEmployerReturnForm.preview.d.ts

@@ -0,0 +1,3 @@
+import { ALEmployerReturnBoundData } from './ALEmployerReturnForm';
+export declare const ALA1_TEMPORARY_BOUND_DATA: ALEmployerReturnBoundData;
+export declare const ALA6_TEMPORARY_BOUND_DATA: ALEmployerReturnBoundData;

package/dist/components/tax-forms/states/alabama/ALEmployerReturnForm.schema.d.ts

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { ALEmployerReturnVariant } from './ALEmployerReturnForm.calc';
+export declare const ACCOUNT_NUMBER_MAX_LENGTH = 10;
+export declare const EMPLOYEE_COUNT_MAX_LENGTH = 12;
+export declare const SIGNER_MAX_LENGTH = 45;
+export declare function createALEmployerReturnSchema(variant: ALEmployerReturnVariant): z.ZodObject<{
+    accountNumber: z.ZodString;
+    periodCovered: z.ZodString;
+    isCancellingAccount: z.ZodBoolean;
+    employeeCount: z.ZodString;
+    taxWithheld: z.ZodObject<{
+        dollars: z.ZodString;
+        cents: z.ZodString;
+    }, z.core.$strip>;
+    priorRemitted: z.ZodObject<{
+        dollars: z.ZodString;
+        cents: z.ZodString;
+    }, z.core.$strip>;
+    credit: z.ZodObject<{
+        dollars: z.ZodString;
+        cents: z.ZodString;
+    }, z.core.$strip>;
+    penalty: z.ZodObject<{
+        dollars: z.ZodString;
+        cents: z.ZodString;
+    }, z.core.$strip>;
+    interest: z.ZodObject<{
+        dollars: z.ZodString;
+        cents: z.ZodString;
+    }, z.core.$strip>;
+    amountRemitted: z.ZodObject<{
+        dollars: z.ZodString;
+        cents: z.ZodString;
+    }, z.core.$strip>;
+    payerId: z.ZodNullable<z.ZodNumber>;
+    name: z.ZodString;
+    address: z.ZodString;
+    city: z.ZodString;
+    state: z.ZodString;
+    zipCode: z.ZodString;
+    isAddressChange: z.ZodBoolean;
+    signature: z.ZodString;
+    title: z.ZodString;
+    signatureDate: z.ZodString;
+}, z.core.$strip>;